This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/burr.git
The following commit(s) were added to refs/heads/asf-staging by this push:
new 2d184df8 Deploy documentation from
1578f1fba7d513f8d85599c97c6419a4248aa1c7
2d184df8 is described below
commit 2d184df80ecee2507bcdb87904a457d97f358cd6
Author: GitHub Actions <[email protected]>
AuthorDate: Mon Mar 16 04:00:58 2026 +0000
Deploy documentation from 1578f1fba7d513f8d85599c97c6419a4248aa1c7
---
.../_sources/getting_started/claude-skill.rst.txt | 439 ++++++++++++++++++++
content/_sources/getting_started/index.rst.txt | 1 +
content/asf/index.html | 1 +
content/concepts/actions/index.html | 1 +
content/concepts/additional-visibility/index.html | 1 +
content/concepts/hooks/index.html | 1 +
content/concepts/index.html | 1 +
content/concepts/overview/index.html | 1 +
content/concepts/parallelism/index.html | 1 +
content/concepts/planned-capabilities/index.html | 1 +
content/concepts/recursion/index.html | 1 +
content/concepts/sdlc/index.html | 1 +
content/concepts/serde/index.html | 1 +
content/concepts/state-machine/index.html | 1 +
content/concepts/state-persistence/index.html | 1 +
content/concepts/state-typing/index.html | 1 +
content/concepts/state/index.html | 1 +
content/concepts/streaming-actions/index.html | 1 +
content/concepts/sync-vs-async/index.html | 1 +
content/concepts/tracking/index.html | 1 +
content/concepts/transitions/index.html | 1 +
content/contributing/architecture/index.html | 1 +
content/contributing/contributing/index.html | 1 +
content/contributing/index.html | 1 +
content/contributing/iterating/index.html | 1 +
content/contributing/setup/index.html | 1 +
content/examples/agents/agent-patterns/index.html | 1 +
.../examples/agents/divide-and-conquer/index.html | 1 +
content/examples/agents/index.html | 1 +
content/examples/chatbots/basic-chatbot/index.html | 1 +
.../examples/chatbots/gpt-like-chatbot/index.html | 1 +
content/examples/chatbots/index.html | 1 +
.../chatbots/rag-chatbot-hamilton/index.html | 1 +
content/examples/data-science/index.html | 1 +
.../examples/data-science/ml_training/index.html | 1 +
.../examples/data-science/simulation/index.html | 1 +
content/examples/deployment/index.html | 1 +
.../examples/deployment/infrastructure/index.html | 1 +
content/examples/deployment/monitoring/index.html | 1 +
content/examples/deployment/web-server/index.html | 1 +
.../examples/guardrails/creating_tests/index.html | 1 +
content/examples/guardrails/index.html | 1 +
content/examples/index.html | 1 +
.../simple/choose-your-own-adventure/index.html | 1 +
content/examples/simple/counter/index.html | 1 +
content/examples/simple/cowsay/index.html | 1 +
content/examples/simple/index.html | 1 +
content/genindex/index.html | 1 +
.../{up-next => claude-skill}/index.html | 458 ++++++++++++++++++---
content/getting_started/index.html | 2 +
content/getting_started/install/index.html | 1 +
content/getting_started/simple-example/index.html | 7 +-
content/getting_started/up-next/index.html | 7 +-
content/getting_started/why-burr/index.html | 1 +
content/index.html | 1 +
content/main/index.html | 1 +
content/objects.inv | Bin 4444 -> 4470 bytes
content/py-modindex/index.html | 1 +
content/reference/actions/index.html | 1 +
content/reference/application/index.html | 1 +
content/reference/conditions/index.html | 1 +
content/reference/index.html | 1 +
content/reference/integrations/hamilton/index.html | 1 +
content/reference/integrations/haystack/index.html | 1 +
content/reference/integrations/index.html | 1 +
.../reference/integrations/langchain/index.html | 1 +
.../integrations/opentelemetry/index.html | 1 +
content/reference/integrations/pydantic/index.html | 1 +
content/reference/integrations/ray/index.html | 1 +
.../reference/integrations/streamlit/index.html | 1 +
.../reference/integrations/traceloop/index.html | 1 +
content/reference/lifecycle/index.html | 1 +
content/reference/parallelism/index.html | 1 +
content/reference/persister/index.html | 1 +
content/reference/serde/index.html | 1 +
content/reference/state/index.html | 1 +
content/reference/tracking/index.html | 1 +
content/reference/typing/index.html | 1 +
content/reference/visibility/index.html | 1 +
content/search/index.html | 1 +
content/searchindex.js | 2 +-
content/sitemap.xml | 2 +-
82 files changed, 931 insertions(+), 60 deletions(-)
diff --git a/content/_sources/getting_started/claude-skill.rst.txt
b/content/_sources/getting_started/claude-skill.rst.txt
new file mode 100644
index 00000000..02de3761
--- /dev/null
+++ b/content/_sources/getting_started/claude-skill.rst.txt
@@ -0,0 +1,439 @@
+..
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+
+==================
+Claude Code Skill
+==================
+
+Apache Burr includes a comprehensive Claude Code skill that makes Claude an
expert in helping you build Burr applications.
+
+What is the Claude Code Skill?
+===============================
+
+The Burr Claude skill is a plugin for `Claude Code
<https://claude.com/claude-code>`_, Anthropic's official CLI tool. When active,
it teaches Claude how to:
+
+* Build new Burr applications from scratch
+* Write properly structured actions and transitions
+* Follow best practices and design patterns
+* Debug common issues
+* Provide working code examples
+* Review your code for correctness
+
+Installation
+============
+
+Option 1: Install from GitHub (Easiest)
+----------------------------------------
+
+Use the Claude CLI to install directly from GitHub:
+
+.. code-block:: bash
+
+ # Install to personal skills directory
+ claude skill install https://github.com/apache/burr/.claude/skills/burr
+
+ # Or install to your current project
+ claude skill install https://github.com/apache/burr/.claude/skills/burr
--project
+
+Option 2: Manual Personal Installation
+---------------------------------------
+
+Copy the skill to your personal Claude skills directory:
+
+.. code-block:: bash
+
+ # Clone the Burr repository
+ git clone https://github.com/apache/burr
+
+ # Copy skill to personal directory
+ cp -r burr/.claude/skills/burr ~/.claude/skills/
+
+Option 3: Manual Project Installation
+--------------------------------------
+
+For team projects, copy the skill to your project's ``.claude/skills/``
directory:
+
+.. code-block:: bash
+
+ # From your project root
+ cp -r /path/to/burr/.claude/skills/burr .claude/skills/
+
+Verify Installation
+-------------------
+
+Check that the skill is available:
+
+.. code-block:: bash
+
+ # In Claude Code, try:
+ /burr --help
+
+Or ask Claude naturally:
+
+ "Help me build a Burr application"
+
+Usage
+=====
+
+Manual Invocation
+-----------------
+
+Use the ``/burr`` command to explicitly invoke the skill:
+
+.. code-block:: text
+
+ /burr How do I create a streaming action?
+
+ /burr Review this action for best practices
+
+ /burr Show me an example of parallel execution
+
+Automatic Invocation
+--------------------
+
+Claude automatically loads the skill when it detects you're working with Burr:
+
+.. code-block:: text
+
+ "I'm building a chatbot with Burr"
+
+ "Why isn't my action updating the state?"
+
+ "Show me how to add persistence"
+
+What Can It Do?
+===============
+
+Code Generation
+---------------
+
+Ask Claude to generate complete Burr applications:
+
+**Example:**
+
+.. code-block:: text
+
+ "Create a Burr application for a RAG chatbot with document retrieval and
reranking"
+
+Claude will generate:
+
+* Action functions with proper ``@action`` decorators
+* State machine transitions with conditions
+* Tracking configuration
+* Complete application setup
+
+Code Review
+-----------
+
+Get feedback on your Burr code:
+
+**Example:**
+
+.. code-block:: text
+
+ "Review this application for best practices"
+
+Claude will check:
+
+* Correct ``reads`` and ``writes`` declarations
+* State immutability
+* Transition coverage
+* Error handling
+* Performance considerations
+
+Learning & Examples
+-------------------
+
+Get working examples for common patterns:
+
+**Example:**
+
+.. code-block:: text
+
+ "Show me how to implement retry logic"
+
+Claude provides:
+
+* Complete working code
+* Explanation of the pattern
+* Best practices
+* References to documentation
+
+Debugging Help
+--------------
+
+Troubleshoot issues with Claude's help:
+
+**Example:**
+
+.. code-block:: text
+
+ "My state machine is looping infinitely"
+
+Claude will:
+
+* Analyze transition logic
+* Suggest using ``.visualize()``
+* Provide solutions
+* Reference troubleshooting docs
+
+Skill Contents
+==============
+
+The skill includes comprehensive documentation:
+
+API Reference
+-------------
+
+Complete documentation of Burr's API:
+
+* Actions and decorators
+* State management
+* ApplicationBuilder
+* Transitions and conditions
+* Persistence
+* Tracking and hooks
+
+Examples
+--------
+
+Working code examples for:
+
+* Basic chatbots
+* Streaming actions
+* Parallel execution
+* Error handling and retries
+* RAG patterns
+* State persistence
+* Testing
+
+Design Patterns
+---------------
+
+Best practices and architectural guidance:
+
+* Single responsibility actions
+* State immutability
+* Deterministic actions
+* Error recovery patterns
+* Multi-stage pipelines
+* Branching decision trees
+
+Troubleshooting
+---------------
+
+Solutions for common issues:
+
+* Installation problems
+* State machine loops
+* State not updating
+* Persistence issues
+* Performance optimization
+
+Common Use Cases
+================
+
+Building a Chatbot
+------------------
+
+.. code-block:: text
+
+ "Help me build a multi-modal chatbot with Burr"
+
+Claude will create a complete chatbot with:
+
+* User input action
+* LLM response action
+* State management for chat history
+* Transitions for conversation flow
+
+Adding Features
+---------------
+
+.. code-block:: text
+
+ "Add streaming responses to my chatbot"
+
+Claude will:
+
+* Show how to convert to a streaming action
+* Provide the generator pattern
+* Update the application setup
+
+Debugging
+---------
+
+.. code-block:: text
+
+ "My action isn't updating state, what's wrong?"
+
+Claude will:
+
+* Review your code
+* Identify the issue (likely missing ``return``)
+* Provide the fix
+* Explain why it matters
+
+Tips for Best Results
+======================
+
+1. **Be specific** - "Help me add retry logic to my fetch action" is better
than "help with errors"
+
+2. **Show your code** - Claude works best when it can see what you're building
+
+3. **Ask for examples** - "Show me an example of..." gets working code
+
+4. **Reference the skill's docs** - Ask Claude to check the API reference or
patterns guide
+
+5. **Use visualization** - Ask Claude to suggest using ``app.visualize()``
when debugging
+
+Example Conversation
+====================
+
+Here's a typical interaction:
+
+.. code-block:: text
+
+ You: I want to build a Burr application that processes documents through
multiple stages
+
+ Claude: I'll help you create a multi-stage document processing pipeline
with Burr.
+ Let me create actions for each stage...
+
+ [Claude generates code with actions for validation, transformation,
enrichment, and output]
+
+ You: How do I add error handling?
+
+ Claude: I'll show you how to add error recovery with retries. Here's the
pattern...
+
+ [Claude adds error handling actions and transitions]
+
+ You: Can you review this code?
+
+ Claude: Let me check your application for best practices...
+
+ [Claude reviews and provides feedback]
+
+Integration with Development
+=============================
+
+The skill integrates seamlessly with your development workflow:
+
+* **During design** - Get help planning your state machine architecture
+* **While coding** - Generate boilerplate and follow patterns
+* **When debugging** - Troubleshoot issues and understand errors
+* **In code review** - Verify best practices are followed
+
+Customizing the Skill
+======================
+
+You can customize the skill for your needs:
+
+1. Edit ``SKILL.md`` to change instructions
+2. Add your own examples to ``examples.md``
+3. Update ``patterns.md`` with team-specific practices
+4. Extend ``api-reference.md`` with custom actions
+
+Example customization:
+
+.. code-block:: bash
+
+ cd ~/.claude/skills/burr
+ # Edit the skill files
+ vim examples.md
+
+Updating the Skill
+==================
+
+To get the latest version:
+
+.. code-block:: bash
+
+ cd /path/to/burr
+ git pull
+ cp -r .claude/skills/burr ~/.claude/skills/
+
+Related Resources
+=================
+
+* `Claude Code Documentation <https://docs.claude.com/claude-code>`_
+* `Burr Examples <https://github.com/apache/burr/tree/main/examples>`_
+* `Burr Discord <https://discord.gg/6Zy2DwP4f3>`_
+
+FAQ
+===
+
+**Do I need Burr installed to use the skill?**
+
+No, but Claude can help you install it when needed.
+
+**Can I use this with other frameworks?**
+
+Yes! Burr integrates well with LangChain, LlamaIndex, Apache Hamilton, and
others.
+
+**Will this work with older Burr versions?**
+
+The skill is designed for current Burr versions. Some APIs may differ in older
releases.
+
+**How do I disable the skill?**
+
+Rename the skill directory:
+
+.. code-block:: bash
+
+ mv ~/.claude/skills/burr ~/.claude/skills/burr.disabled
+
+**Can I share my customizations?**
+
+Yes! Contribute improvements back to the project via pull request.
+
+Contributing
+============
+
+Found an issue or want to improve the skill? We welcome contributions!
+
+Reporting Issues
+----------------
+
+If you find a bug or have a suggestion:
+
+1. Check existing issues at https://github.com/apache/burr/issues
+2. Open a new issue with:
+
+ * Clear description of the problem or suggestion
+ * Steps to reproduce (for bugs)
+ * Expected vs actual behavior
+ * Burr version and environment details
+
+Contributing Improvements
+-------------------------
+
+We especially appreciate pull requests! To contribute:
+
+1. Fork the repository
+2. Edit the skill files in ``.claude/skills/burr/``
+3. Test your changes with Claude Code
+4. Submit a PR to https://github.com/apache/burr with:
+
+ * Clear description of what you changed and why
+ * Examples showing the improvement
+ * Any relevant issue references
+
+Small fixes like typos, improved examples, or clearer explanations are always
welcome!
+
+The Burr community appreciates all contributions, big and small.
diff --git a/content/_sources/getting_started/index.rst.txt
b/content/_sources/getting_started/index.rst.txt
index bd5d29c7..5594161d 100644
--- a/content/_sources/getting_started/index.rst.txt
+++ b/content/_sources/getting_started/index.rst.txt
@@ -31,4 +31,5 @@ The following section of the docs will walk you through Burr
and how to integrat
why-burr
install
simple-example
+ claude-skill
up-next
diff --git a/content/asf/index.html b/content/asf/index.html
index 4b78287e..c2eda212 100644
--- a/content/asf/index.html
+++ b/content/asf/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/actions/index.html
b/content/concepts/actions/index.html
index 5c6ada06..09b43fef 100644
--- a/content/concepts/actions/index.html
+++ b/content/concepts/actions/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/additional-visibility/index.html
b/content/concepts/additional-visibility/index.html
index a765a0cd..1769463e 100644
--- a/content/concepts/additional-visibility/index.html
+++ b/content/concepts/additional-visibility/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/hooks/index.html
b/content/concepts/hooks/index.html
index 556177b0..ed131b63 100644
--- a/content/concepts/hooks/index.html
+++ b/content/concepts/hooks/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/index.html b/content/concepts/index.html
index a696ef49..b10ce078 100644
--- a/content/concepts/index.html
+++ b/content/concepts/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/overview/index.html
b/content/concepts/overview/index.html
index 992815ae..d483a5e3 100644
--- a/content/concepts/overview/index.html
+++ b/content/concepts/overview/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/parallelism/index.html
b/content/concepts/parallelism/index.html
index 6bc5d2d8..db799d56 100644
--- a/content/concepts/parallelism/index.html
+++ b/content/concepts/parallelism/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/planned-capabilities/index.html
b/content/concepts/planned-capabilities/index.html
index e8c8f2ac..0d719cbf 100644
--- a/content/concepts/planned-capabilities/index.html
+++ b/content/concepts/planned-capabilities/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/recursion/index.html
b/content/concepts/recursion/index.html
index 7a2bc086..e2f0dc4f 100644
--- a/content/concepts/recursion/index.html
+++ b/content/concepts/recursion/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/sdlc/index.html b/content/concepts/sdlc/index.html
index 71b5ef96..8159d51d 100644
--- a/content/concepts/sdlc/index.html
+++ b/content/concepts/sdlc/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/serde/index.html
b/content/concepts/serde/index.html
index a753081c..ed92d02c 100644
--- a/content/concepts/serde/index.html
+++ b/content/concepts/serde/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/state-machine/index.html
b/content/concepts/state-machine/index.html
index a7cb916b..ed8ce53c 100644
--- a/content/concepts/state-machine/index.html
+++ b/content/concepts/state-machine/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/state-persistence/index.html
b/content/concepts/state-persistence/index.html
index 1f5d2623..0b57da7b 100644
--- a/content/concepts/state-persistence/index.html
+++ b/content/concepts/state-persistence/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/state-typing/index.html
b/content/concepts/state-typing/index.html
index f4f2baf5..b90dc4e3 100644
--- a/content/concepts/state-typing/index.html
+++ b/content/concepts/state-typing/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/state/index.html
b/content/concepts/state/index.html
index 43a3cf13..b3e85481 100644
--- a/content/concepts/state/index.html
+++ b/content/concepts/state/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/streaming-actions/index.html
b/content/concepts/streaming-actions/index.html
index 71f02dac..0e897fb8 100644
--- a/content/concepts/streaming-actions/index.html
+++ b/content/concepts/streaming-actions/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/sync-vs-async/index.html
b/content/concepts/sync-vs-async/index.html
index 7b29bfb4..248b8b46 100644
--- a/content/concepts/sync-vs-async/index.html
+++ b/content/concepts/sync-vs-async/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/tracking/index.html
b/content/concepts/tracking/index.html
index 87a41cb4..2e07b9c1 100644
--- a/content/concepts/tracking/index.html
+++ b/content/concepts/tracking/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/concepts/transitions/index.html
b/content/concepts/transitions/index.html
index 3ddc3c62..73c9c932 100644
--- a/content/concepts/transitions/index.html
+++ b/content/concepts/transitions/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/contributing/architecture/index.html
b/content/contributing/architecture/index.html
index d25fc3c7..3f2eb6b3 100644
--- a/content/contributing/architecture/index.html
+++ b/content/contributing/architecture/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/contributing/contributing/index.html
b/content/contributing/contributing/index.html
index 2250cf7b..815b45f6 100644
--- a/content/contributing/contributing/index.html
+++ b/content/contributing/contributing/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/contributing/index.html b/content/contributing/index.html
index 0a602ddf..433fa179 100644
--- a/content/contributing/index.html
+++ b/content/contributing/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/contributing/iterating/index.html
b/content/contributing/iterating/index.html
index 5fdd79f2..19f6b9d1 100644
--- a/content/contributing/iterating/index.html
+++ b/content/contributing/iterating/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/contributing/setup/index.html
b/content/contributing/setup/index.html
index 6d30b25d..53cc44e9 100644
--- a/content/contributing/setup/index.html
+++ b/content/contributing/setup/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/agents/agent-patterns/index.html
b/content/examples/agents/agent-patterns/index.html
index a5f9f315..112efc0b 100644
--- a/content/examples/agents/agent-patterns/index.html
+++ b/content/examples/agents/agent-patterns/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/agents/divide-and-conquer/index.html
b/content/examples/agents/divide-and-conquer/index.html
index 9c921ef8..3d0b98c6 100644
--- a/content/examples/agents/divide-and-conquer/index.html
+++ b/content/examples/agents/divide-and-conquer/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/agents/index.html
b/content/examples/agents/index.html
index fe6660b8..e1219c51 100644
--- a/content/examples/agents/index.html
+++ b/content/examples/agents/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/chatbots/basic-chatbot/index.html
b/content/examples/chatbots/basic-chatbot/index.html
index 5383006f..e9323da8 100644
--- a/content/examples/chatbots/basic-chatbot/index.html
+++ b/content/examples/chatbots/basic-chatbot/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/chatbots/gpt-like-chatbot/index.html
b/content/examples/chatbots/gpt-like-chatbot/index.html
index f7426c71..fd638780 100644
--- a/content/examples/chatbots/gpt-like-chatbot/index.html
+++ b/content/examples/chatbots/gpt-like-chatbot/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/chatbots/index.html
b/content/examples/chatbots/index.html
index 0cb89187..0eb0dc2f 100644
--- a/content/examples/chatbots/index.html
+++ b/content/examples/chatbots/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/chatbots/rag-chatbot-hamilton/index.html
b/content/examples/chatbots/rag-chatbot-hamilton/index.html
index 9543f18c..c22fa138 100644
--- a/content/examples/chatbots/rag-chatbot-hamilton/index.html
+++ b/content/examples/chatbots/rag-chatbot-hamilton/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/data-science/index.html
b/content/examples/data-science/index.html
index 97923938..597df2e8 100644
--- a/content/examples/data-science/index.html
+++ b/content/examples/data-science/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/data-science/ml_training/index.html
b/content/examples/data-science/ml_training/index.html
index 5387941c..07b81693 100644
--- a/content/examples/data-science/ml_training/index.html
+++ b/content/examples/data-science/ml_training/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/data-science/simulation/index.html
b/content/examples/data-science/simulation/index.html
index f8d65d85..20f23747 100644
--- a/content/examples/data-science/simulation/index.html
+++ b/content/examples/data-science/simulation/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/deployment/index.html
b/content/examples/deployment/index.html
index bb13b3a9..a13c0129 100644
--- a/content/examples/deployment/index.html
+++ b/content/examples/deployment/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/deployment/infrastructure/index.html
b/content/examples/deployment/infrastructure/index.html
index fed3961e..33c3ff8b 100644
--- a/content/examples/deployment/infrastructure/index.html
+++ b/content/examples/deployment/infrastructure/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/deployment/monitoring/index.html
b/content/examples/deployment/monitoring/index.html
index ec2465a5..34d10c08 100644
--- a/content/examples/deployment/monitoring/index.html
+++ b/content/examples/deployment/monitoring/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/deployment/web-server/index.html
b/content/examples/deployment/web-server/index.html
index d10710ee..69bb9148 100644
--- a/content/examples/deployment/web-server/index.html
+++ b/content/examples/deployment/web-server/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/guardrails/creating_tests/index.html
b/content/examples/guardrails/creating_tests/index.html
index 562e8da3..eacec02a 100644
--- a/content/examples/guardrails/creating_tests/index.html
+++ b/content/examples/guardrails/creating_tests/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/guardrails/index.html
b/content/examples/guardrails/index.html
index 4c265ac2..c5161e66 100644
--- a/content/examples/guardrails/index.html
+++ b/content/examples/guardrails/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/index.html b/content/examples/index.html
index 15f5cd5e..ba15b22f 100644
--- a/content/examples/index.html
+++ b/content/examples/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/simple/choose-your-own-adventure/index.html
b/content/examples/simple/choose-your-own-adventure/index.html
index 6a196737..e1f0c2e3 100644
--- a/content/examples/simple/choose-your-own-adventure/index.html
+++ b/content/examples/simple/choose-your-own-adventure/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/simple/counter/index.html
b/content/examples/simple/counter/index.html
index 59f81936..63e39ef6 100644
--- a/content/examples/simple/counter/index.html
+++ b/content/examples/simple/counter/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/simple/cowsay/index.html
b/content/examples/simple/cowsay/index.html
index a6620b70..2c519a5c 100644
--- a/content/examples/simple/cowsay/index.html
+++ b/content/examples/simple/cowsay/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/examples/simple/index.html
b/content/examples/simple/index.html
index 50095312..8d9b6a61 100644
--- a/content/examples/simple/index.html
+++ b/content/examples/simple/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/genindex/index.html b/content/genindex/index.html
index 29723538..f282e56d 100644
--- a/content/genindex/index.html
+++ b/content/genindex/index.html
@@ -243,6 +243,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/getting_started/up-next/index.html
b/content/getting_started/claude-skill/index.html
similarity index 59%
copy from content/getting_started/up-next/index.html
copy to content/getting_started/claude-skill/index.html
index 9a5513d3..ff76d4af 100644
--- a/content/getting_started/up-next/index.html
+++ b/content/getting_started/claude-skill/index.html
@@ -22,11 +22,11 @@
<head><meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="color-scheme" content="light dark"><meta name="viewport"
content="width=device-width, initial-scale=1" />
-<link rel="index" title="Index" href="../../genindex/"><link rel="search"
title="Search" href="../../search/"><link rel="next" title="Cookbook"
href="../../examples/"><link rel="prev" title="Quickstart"
href="../simple-example/">
- <link rel="canonical"
href="https://burr.staged.apache.org/getting_started/up-next/";>
+<link rel="index" title="Index" href="../../genindex/"><link rel="search"
title="Search" href="../../search/"><link rel="next" title="Next Steps"
href="../up-next/"><link rel="prev" title="Quickstart"
href="../simple-example/">
+ <link rel="canonical"
href="https://burr.staged.apache.org/getting_started/claude-skill/";>
<link rel="shortcut icon" href="../../_static/favicon.ico"><!-- Generated
with Sphinx 8.2.3 and Furo 2025.12.19 -->
- <title>Next Steps - Apache Burr</title>
+ <title>Claude Code Skill - Apache Burr</title>
<link rel="stylesheet" type="text/css"
href="../../_static/pygments.css?v=d111a655" />
<link rel="stylesheet" type="text/css"
href="../../_static/styles/furo.css?v=7bdb33bb" />
<link rel="stylesheet" type="text/css"
href="../../_static/mystnb.11b39860a7a0cbfd473a3ad8a317855267ff0bd372690045ca344a6b62be495e.css"
/>
@@ -245,7 +245,8 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal" href="../why-burr/">Why
Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../simple-example/">Quickstart</a></li>
-<li class="toctree-l2 current current-page"><a class="current reference
internal" href="#">Next Steps</a></li>
+<li class="toctree-l2 current current-page"><a class="current reference
internal" href="#">Claude Code Skill</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../up-next/">Next
Steps</a></li>
</ul>
</li>
<li class="toctree-l1 has-children"><a class="reference internal"
href="../../examples/">Cookbook</a><input aria-label="Toggle navigation of
Cookbook" class="toctree-checkbox" id="toctree-checkbox-2"
name="toctree-checkbox-2" role="switch" type="checkbox"/><label
for="toctree-checkbox-2"><span class="icon"><svg><use
href="#svg-arrow-right"></use></svg></span></label><ul>
@@ -377,12 +378,12 @@ s=d.getElementsByTagName('script')[0];
</a>
<div class="content-icon-container">
<div class="view-this-page">
- <a class="muted-link"
href="https://github.com/apache/burr/blob/main/docs/getting_started/up-next.rst?plain=true";
title="View this page">
+ <a class="muted-link"
href="https://github.com/apache/burr/blob/main/docs/getting_started/claude-skill.rst?plain=true";
title="View this page">
<svg><use href="#svg-eye"></use></svg>
<span class="visually-hidden">View this page</span>
</a>
</div><div class="edit-this-page">
- <a class="muted-link"
href="https://github.com/apache/burr/edit/main/docs/getting_started/up-next.rst";
rel="edit" title="Edit this page">
+ <a class="muted-link"
href="https://github.com/apache/burr/edit/main/docs/getting_started/claude-skill.rst";
rel="edit" title="Edit this page">
<svg><use href="#svg-pencil"></use></svg>
<span class="visually-hidden">Edit this page</span>
</a>
@@ -399,62 +400,377 @@ s=d.getElementsByTagName('script')[0];
</label>
</div>
<article role="main" id="furo-main-content">
- <section id="next-steps">
-<h1>Next Steps<a class="headerlink" href="#next-steps" title="Link to this
heading">¶</a></h1>
-<p>You’ve written your own burr application in a few lines of code. Nice work!
Let’s look at some less trivial examples.
-All of the following are pre-populated in the UI under <code class="docutils
literal notranslate"><span class="pre">projects/</span></code>. You can start
the UI by running:</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>burr
+ <section id="claude-code-skill">
+<h1>Claude Code Skill<a class="headerlink" href="#claude-code-skill"
title="Link to this heading">¶</a></h1>
+<p>Apache Burr includes a comprehensive Claude Code skill that makes Claude an
expert in helping you build Burr applications.</p>
+<section id="what-is-the-claude-code-skill">
+<h2>What is the Claude Code Skill?<a class="headerlink"
href="#what-is-the-claude-code-skill" title="Link to this heading">¶</a></h2>
+<p>The Burr Claude skill is a plugin for <a class="reference external"
href="https://claude.com/claude-code";>Claude Code</a>, Anthropic’s official CLI
tool. When active, it teaches Claude how to:</p>
+<ul class="simple">
+<li><p>Build new Burr applications from scratch</p></li>
+<li><p>Write properly structured actions and transitions</p></li>
+<li><p>Follow best practices and design patterns</p></li>
+<li><p>Debug common issues</p></li>
+<li><p>Provide working code examples</p></li>
+<li><p>Review your code for correctness</p></li>
+</ul>
+</section>
+<section id="installation">
+<h2>Installation<a class="headerlink" href="#installation" title="Link to this
heading">¶</a></h2>
+<section id="option-1-install-from-github-easiest">
+<h3>Option 1: Install from GitHub (Easiest)<a class="headerlink"
href="#option-1-install-from-github-easiest" title="Link to this
heading">¶</a></h3>
+<p>Use the Claude CLI to install directly from GitHub:</p>
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span><span class="c1"># Install to personal
skills directory</span>
+claude<span class="w"> </span>skill<span class="w"> </span>install<span
class="w"> </span>https://github.com/apache/burr/.claude/skills/burr
+
+<span class="c1"># Or install to your current project</span>
+claude<span class="w"> </span>skill<span class="w"> </span>install<span
class="w"> </span>https://github.com/apache/burr/.claude/skills/burr<span
class="w"> </span>--project
+</pre></div>
+</div>
+</section>
+<section id="option-2-manual-personal-installation">
+<h3>Option 2: Manual Personal Installation<a class="headerlink"
href="#option-2-manual-personal-installation" title="Link to this
heading">¶</a></h3>
+<p>Copy the skill to your personal Claude skills directory:</p>
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span><span class="c1"># Clone the Burr
repository</span>
+git<span class="w"> </span>clone<span class="w">
</span>https://github.com/apache/burr
+
+<span class="c1"># Copy skill to personal directory</span>
+cp<span class="w"> </span>-r<span class="w">
</span>burr/.claude/skills/burr<span class="w"> </span>~/.claude/skills/
+</pre></div>
+</div>
+</section>
+<section id="option-3-manual-project-installation">
+<h3>Option 3: Manual Project Installation<a class="headerlink"
href="#option-3-manual-project-installation" title="Link to this
heading">¶</a></h3>
+<p>For team projects, copy the skill to your project’s <code class="docutils
literal notranslate"><span class="pre">.claude/skills/</span></code>
directory:</p>
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span><span class="c1"># From your project
root</span>
+cp<span class="w"> </span>-r<span class="w">
</span>/path/to/burr/.claude/skills/burr<span class="w"> </span>.claude/skills/
+</pre></div>
+</div>
+</section>
+<section id="verify-installation">
+<h3>Verify Installation<a class="headerlink" href="#verify-installation"
title="Link to this heading">¶</a></h3>
+<p>Check that the skill is available:</p>
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span><span class="c1"># In Claude Code,
try:</span>
+/burr<span class="w"> </span>--help
+</pre></div>
+</div>
+<p>Or ask Claude naturally:</p>
+<blockquote>
+<div><p>“Help me build a Burr application”</p>
+</div></blockquote>
+</section>
+</section>
+<section id="usage">
+<h2>Usage<a class="headerlink" href="#usage" title="Link to this
heading">¶</a></h2>
+<section id="manual-invocation">
+<h3>Manual Invocation<a class="headerlink" href="#manual-invocation"
title="Link to this heading">¶</a></h3>
+<p>Use the <code class="docutils literal notranslate"><span
class="pre">/burr</span></code> command to explicitly invoke the skill:</p>
+<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>/burr How do I create a streaming action?
+
+/burr Review this action for best practices
+
+/burr Show me an example of parallel execution
+</pre></div>
+</div>
+</section>
+<section id="automatic-invocation">
+<h3>Automatic Invocation<a class="headerlink" href="#automatic-invocation"
title="Link to this heading">¶</a></h3>
+<p>Claude automatically loads the skill when it detects you’re working with
Burr:</p>
+<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>"I'm building a chatbot with
Burr"
+
+"Why isn't my action updating the state?"
+
+"Show me how to add persistence"
+</pre></div>
+</div>
+</section>
+</section>
+<section id="what-can-it-do">
+<h2>What Can It Do?<a class="headerlink" href="#what-can-it-do" title="Link to
this heading">¶</a></h2>
+<section id="code-generation">
+<h3>Code Generation<a class="headerlink" href="#code-generation" title="Link
to this heading">¶</a></h3>
+<p>Ask Claude to generate complete Burr applications:</p>
+<p><strong>Example:</strong></p>
+<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>"Create a Burr application for a RAG
chatbot with document retrieval and reranking"
+</pre></div>
+</div>
+<p>Claude will generate:</p>
+<ul class="simple">
+<li><p>Action functions with proper <code class="docutils literal
notranslate"><span class="pre">@action</span></code> decorators</p></li>
+<li><p>State machine transitions with conditions</p></li>
+<li><p>Tracking configuration</p></li>
+<li><p>Complete application setup</p></li>
+</ul>
+</section>
+<section id="code-review">
+<h3>Code Review<a class="headerlink" href="#code-review" title="Link to this
heading">¶</a></h3>
+<p>Get feedback on your Burr code:</p>
+<p><strong>Example:</strong></p>
+<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>"Review this application for best
practices"
+</pre></div>
+</div>
+<p>Claude will check:</p>
+<ul class="simple">
+<li><p>Correct <code class="docutils literal notranslate"><span
class="pre">reads</span></code> and <code class="docutils literal
notranslate"><span class="pre">writes</span></code> declarations</p></li>
+<li><p>State immutability</p></li>
+<li><p>Transition coverage</p></li>
+<li><p>Error handling</p></li>
+<li><p>Performance considerations</p></li>
+</ul>
+</section>
+<section id="learning-examples">
+<h3>Learning & Examples<a class="headerlink" href="#learning-examples"
title="Link to this heading">¶</a></h3>
+<p>Get working examples for common patterns:</p>
+<p><strong>Example:</strong></p>
+<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>"Show me how to implement retry
logic"
+</pre></div>
+</div>
+<p>Claude provides:</p>
+<ul class="simple">
+<li><p>Complete working code</p></li>
+<li><p>Explanation of the pattern</p></li>
+<li><p>Best practices</p></li>
+<li><p>References to documentation</p></li>
+</ul>
+</section>
+<section id="debugging-help">
+<h3>Debugging Help<a class="headerlink" href="#debugging-help" title="Link to
this heading">¶</a></h3>
+<p>Troubleshoot issues with Claude’s help:</p>
+<p><strong>Example:</strong></p>
+<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>"My state machine is looping
infinitely"
+</pre></div>
+</div>
+<p>Claude will:</p>
+<ul class="simple">
+<li><p>Analyze transition logic</p></li>
+<li><p>Suggest using <code class="docutils literal notranslate"><span
class="pre">.visualize()</span></code></p></li>
+<li><p>Provide solutions</p></li>
+<li><p>Reference troubleshooting docs</p></li>
+</ul>
+</section>
+</section>
+<section id="skill-contents">
+<h2>Skill Contents<a class="headerlink" href="#skill-contents" title="Link to
this heading">¶</a></h2>
+<p>The skill includes comprehensive documentation:</p>
+<section id="api-reference">
+<h3>API Reference<a class="headerlink" href="#api-reference" title="Link to
this heading">¶</a></h3>
+<p>Complete documentation of Burr’s API:</p>
+<ul class="simple">
+<li><p>Actions and decorators</p></li>
+<li><p>State management</p></li>
+<li><p>ApplicationBuilder</p></li>
+<li><p>Transitions and conditions</p></li>
+<li><p>Persistence</p></li>
+<li><p>Tracking and hooks</p></li>
+</ul>
+</section>
+<section id="examples">
+<h3>Examples<a class="headerlink" href="#examples" title="Link to this
heading">¶</a></h3>
+<p>Working code examples for:</p>
+<ul class="simple">
+<li><p>Basic chatbots</p></li>
+<li><p>Streaming actions</p></li>
+<li><p>Parallel execution</p></li>
+<li><p>Error handling and retries</p></li>
+<li><p>RAG patterns</p></li>
+<li><p>State persistence</p></li>
+<li><p>Testing</p></li>
+</ul>
+</section>
+<section id="design-patterns">
+<h3>Design Patterns<a class="headerlink" href="#design-patterns" title="Link
to this heading">¶</a></h3>
+<p>Best practices and architectural guidance:</p>
+<ul class="simple">
+<li><p>Single responsibility actions</p></li>
+<li><p>State immutability</p></li>
+<li><p>Deterministic actions</p></li>
+<li><p>Error recovery patterns</p></li>
+<li><p>Multi-stage pipelines</p></li>
+<li><p>Branching decision trees</p></li>
+</ul>
+</section>
+<section id="troubleshooting">
+<h3>Troubleshooting<a class="headerlink" href="#troubleshooting" title="Link
to this heading">¶</a></h3>
+<p>Solutions for common issues:</p>
+<ul class="simple">
+<li><p>Installation problems</p></li>
+<li><p>State machine loops</p></li>
+<li><p>State not updating</p></li>
+<li><p>Persistence issues</p></li>
+<li><p>Performance optimization</p></li>
+</ul>
+</section>
+</section>
+<section id="common-use-cases">
+<h2>Common Use Cases<a class="headerlink" href="#common-use-cases" title="Link
to this heading">¶</a></h2>
+<section id="building-a-chatbot">
+<h3>Building a Chatbot<a class="headerlink" href="#building-a-chatbot"
title="Link to this heading">¶</a></h3>
+<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>"Help me build a multi-modal chatbot
with Burr"
</pre></div>
</div>
-<section id="telemetry-ui-chatbot-demo-demo-chatbot">
-<h2>Telemetry UI chatbot demo <code class="docutils literal notranslate"><span
class="pre">demo_chatbot</span></code><a class="headerlink"
href="#telemetry-ui-chatbot-demo-demo-chatbot" title="Link to this
heading">¶</a></h2>
-<p>You’ll need the env variable <code class="docutils literal
notranslate"><span class="pre">OPENAI_API_KEY</span></code> set to your api key
for this to work. If you don’t
-have one, you’ll still be able to run it and explore, you just won’t be able
to chat.</p>
-<p>If you haven’t already:</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>pip<span class="w"> </span>install<span
class="w"> </span>burr<span class="o">[</span>start<span class="o">]</span>
+<p>Claude will create a complete chatbot with:</p>
+<ul class="simple">
+<li><p>User input action</p></li>
+<li><p>LLM response action</p></li>
+<li><p>State management for chat history</p></li>
+<li><p>Transitions for conversation flow</p></li>
+</ul>
+</section>
+<section id="adding-features">
+<h3>Adding Features<a class="headerlink" href="#adding-features" title="Link
to this heading">¶</a></h3>
+<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>"Add streaming responses to my
chatbot"
</pre></div>
</div>
-<p>Then:</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>burr-demo
+<p>Claude will:</p>
+<ul class="simple">
+<li><p>Show how to convert to a streaming action</p></li>
+<li><p>Provide the generator pattern</p></li>
+<li><p>Update the application setup</p></li>
+</ul>
+</section>
+<section id="debugging">
+<h3>Debugging<a class="headerlink" href="#debugging" title="Link to this
heading">¶</a></h3>
+<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>"My action isn't updating state,
what's wrong?"
</pre></div>
</div>
-<p>If you’ve run <code class="docutils literal notranslate"><span
class="pre">burr</span></code> and have it open on port 7241, just navigate to
<a class="reference external"
href="http://localhost:7241/demos/chatbot";>demos/chatbot</a>.</p>
+<p>Claude will:</p>
+<ul class="simple">
+<li><p>Review your code</p></li>
+<li><p>Identify the issue (likely missing <code class="docutils literal
notranslate"><span class="pre">return</span></code>)</p></li>
+<li><p>Provide the fix</p></li>
+<li><p>Explain why it matters</p></li>
+</ul>
</section>
-<section id="repository-examples">
-<h2>Repository Examples<a class="headerlink" href="#repository-examples"
title="Link to this heading">¶</a></h2>
-<p>For the next examples you’ll need the repository cloned:</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>git<span class="w"> </span>clone<span
class="w"> </span>https://github.com/apache/burr<span class="w"> </span><span
class="o">&&</span><span class="w"> </span><span
class="nb">cd</span><span class="w"> </span>burr
+</section>
+<section id="tips-for-best-results">
+<h2>Tips for Best Results<a class="headerlink" href="#tips-for-best-results"
title="Link to this heading">¶</a></h2>
+<ol class="arabic simple">
+<li><p><strong>Be specific</strong> - “Help me add retry logic to my fetch
action” is better than “help with errors”</p></li>
+<li><p><strong>Show your code</strong> - Claude works best when it can see
what you’re building</p></li>
+<li><p><strong>Ask for examples</strong> - “Show me an example of…” gets
working code</p></li>
+<li><p><strong>Reference the skill’s docs</strong> - Ask Claude to check the
API reference or patterns guide</p></li>
+<li><p><strong>Use visualization</strong> - Ask Claude to suggest using <code
class="docutils literal notranslate"><span
class="pre">app.visualize()</span></code> when debugging</p></li>
+</ol>
+</section>
+<section id="example-conversation">
+<h2>Example Conversation<a class="headerlink" href="#example-conversation"
title="Link to this heading">¶</a></h2>
+<p>Here’s a typical interaction:</p>
+<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>You: I want to build a Burr application
that processes documents through multiple stages
+
+Claude: I'll help you create a multi-stage document processing pipeline
with Burr.
+Let me create actions for each stage...
+
+[Claude generates code with actions for validation, transformation,
enrichment, and output]
+
+You: How do I add error handling?
+
+Claude: I'll show you how to add error recovery with retries. Here's
the pattern...
+
+[Claude adds error handling actions and transitions]
+
+You: Can you review this code?
+
+Claude: Let me check your application for best practices...
+
+[Claude reviews and provides feedback]
</pre></div>
</div>
-<section id="simple-counter-demo-counter">
-<h3>Simple Counter <code class="docutils literal notranslate"><span
class="pre">demo_counter</span></code><a class="headerlink"
href="#simple-counter-demo-counter" title="Link to this heading">¶</a></h3>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span><span class="nb">cd</span><span class="w">
</span>examples/hello-world-counter
-python<span class="w"> </span>application.py
+</section>
+<section id="integration-with-development">
+<h2>Integration with Development<a class="headerlink"
href="#integration-with-development" title="Link to this heading">¶</a></h2>
+<p>The skill integrates seamlessly with your development workflow:</p>
+<ul class="simple">
+<li><p><strong>During design</strong> - Get help planning your state machine
architecture</p></li>
+<li><p><strong>While coding</strong> - Generate boilerplate and follow
patterns</p></li>
+<li><p><strong>When debugging</strong> - Troubleshoot issues and understand
errors</p></li>
+<li><p><strong>In code review</strong> - Verify best practices are
followed</p></li>
+</ul>
+</section>
+<section id="customizing-the-skill">
+<h2>Customizing the Skill<a class="headerlink" href="#customizing-the-skill"
title="Link to this heading">¶</a></h2>
+<p>You can customize the skill for your needs:</p>
+<ol class="arabic simple">
+<li><p>Edit <code class="docutils literal notranslate"><span
class="pre">SKILL.md</span></code> to change instructions</p></li>
+<li><p>Add your own examples to <code class="docutils literal
notranslate"><span class="pre">examples.md</span></code></p></li>
+<li><p>Update <code class="docutils literal notranslate"><span
class="pre">patterns.md</span></code> with team-specific practices</p></li>
+<li><p>Extend <code class="docutils literal notranslate"><span
class="pre">api-reference.md</span></code> with custom actions</p></li>
+</ol>
+<p>Example customization:</p>
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span><span class="nb">cd</span><span class="w">
</span>~/.claude/skills/burr
+<span class="c1"># Edit the skill files</span>
+vim<span class="w"> </span>examples.md
</pre></div>
</div>
</section>
-<section id="interactive-rag-demo-conversational-rag">
-<h3>Interactive RAG <code class="docutils literal notranslate"><span
class="pre">demo_conversational-rag</span></code><a class="headerlink"
href="#interactive-rag-demo-conversational-rag" title="Link to this
heading">¶</a></h3>
-<p>This is a toy interactive RAG example. You’ll ask questions in the terminal
about information it already has…</p>
-<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span><span class="nb">cd</span><span class="w">
</span>examples/conversational-rag/simple_example
-pip<span class="w"> </span>install<span class="w"> </span>-r<span class="w">
</span>requirements.txt
-python<span class="w"> </span>application.py
+<section id="updating-the-skill">
+<h2>Updating the Skill<a class="headerlink" href="#updating-the-skill"
title="Link to this heading">¶</a></h2>
+<p>To get the latest version:</p>
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span><span class="nb">cd</span><span class="w">
</span>/path/to/burr
+git<span class="w"> </span>pull
+cp<span class="w"> </span>-r<span class="w"> </span>.claude/skills/burr<span
class="w"> </span>~/.claude/skills/
</pre></div>
</div>
</section>
+<section id="related-resources">
+<h2>Related Resources<a class="headerlink" href="#related-resources"
title="Link to this heading">¶</a></h2>
+<ul class="simple">
+<li><p><a class="reference external"
href="https://docs.claude.com/claude-code";>Claude Code
Documentation</a></p></li>
+<li><p><a class="reference external"
href="https://github.com/apache/burr/tree/main/examples";>Burr
Examples</a></p></li>
+<li><p><a class="reference external" href="https://discord.gg/6Zy2DwP4f3";>Burr
Discord</a></p></li>
+</ul>
+</section>
+<section id="faq">
+<h2>FAQ<a class="headerlink" href="#faq" title="Link to this
heading">¶</a></h2>
+<p><strong>Do I need Burr installed to use the skill?</strong></p>
+<p>No, but Claude can help you install it when needed.</p>
+<p><strong>Can I use this with other frameworks?</strong></p>
+<p>Yes! Burr integrates well with LangChain, LlamaIndex, Apache Hamilton, and
others.</p>
+<p><strong>Will this work with older Burr versions?</strong></p>
+<p>The skill is designed for current Burr versions. Some APIs may differ in
older releases.</p>
+<p><strong>How do I disable the skill?</strong></p>
+<p>Rename the skill directory:</p>
+<div class="highlight-bash notranslate"><div
class="highlight"><pre><span></span>mv<span class="w">
</span>~/.claude/skills/burr<span class="w">
</span>~/.claude/skills/burr.disabled
+</pre></div>
+</div>
+<p><strong>Can I share my customizations?</strong></p>
+<p>Yes! Contribute improvements back to the project via pull request.</p>
+</section>
+<section id="contributing">
+<h2>Contributing<a class="headerlink" href="#contributing" title="Link to this
heading">¶</a></h2>
+<p>Found an issue or want to improve the skill? We welcome contributions!</p>
+<section id="reporting-issues">
+<h3>Reporting Issues<a class="headerlink" href="#reporting-issues" title="Link
to this heading">¶</a></h3>
+<p>If you find a bug or have a suggestion:</p>
+<ol class="arabic simple">
+<li><p>Check existing issues at <a class="reference external"
href="https://github.com/apache/burr/issues";>https://github.com/apache/burr/issues</a></p></li>
+<li><p>Open a new issue with:</p>
+<ul class="simple">
+<li><p>Clear description of the problem or suggestion</p></li>
+<li><p>Steps to reproduce (for bugs)</p></li>
+<li><p>Expected vs actual behavior</p></li>
+<li><p>Burr version and environment details</p></li>
+</ul>
+</li>
+</ol>
</section>
-<section id="understanding-concepts">
-<h2>Understanding Concepts<a class="headerlink" href="#understanding-concepts"
title="Link to this heading">¶</a></h2>
-<p>If you’re more comfortable learning through concepts start here.</p>
-<p>Once you’re comfortable with the UI, you may want to get a sense of a few
of the capabilities
-of the Burr library and where you can go to learn more about them:</p>
+<section id="contributing-improvements">
+<h3>Contributing Improvements<a class="headerlink"
href="#contributing-improvements" title="Link to this heading">¶</a></h3>
+<p>We especially appreciate pull requests! To contribute:</p>
+<ol class="arabic simple">
+<li><p>Fork the repository</p></li>
+<li><p>Edit the skill files in <code class="docutils literal
notranslate"><span class="pre">.claude/skills/burr/</span></code></p></li>
+<li><p>Test your changes with Claude Code</p></li>
+<li><p>Submit a PR to <a class="reference external"
href="https://github.com/apache/burr";>https://github.com/apache/burr</a>
with:</p>
<ul class="simple">
-<li><p><a class="reference internal" href="../../concepts/actions/#id1"><span
class="std std-ref">Creating custom actions</span></a> and calling out to
integrated frameworks</p></li>
-<li><p><a class="reference internal"
href="../../concepts/state-machine/#id1"><span class="std std-ref">Running
applications</span></a>, managing their lifeycyle, and inspecting the
results</p></li>
-<li><p><a class="reference internal" href="../../concepts/state/#id1"><span
class="std std-ref">Managing state</span></a> – persisting, inspecting, and
updating</p></li>
-<li><p><a class="reference internal"
href="../../concepts/transitions/#id1"><span class="std std-ref">Handling
transition between nodes</span></a> and managing the flow of your
application</p></li>
-<li><p><a class="reference internal" href="../../concepts/hooks/#id1"><span
class="std std-ref">Adding hooks to customize execution</span></a> and
integrate with other systems</p></li>
+<li><p>Clear description of what you changed and why</p></li>
+<li><p>Examples showing the improvement</p></li>
+<li><p>Any relevant issue references</p></li>
</ul>
+</li>
+</ol>
+<p>Small fixes like typos, improved examples, or clearer explanations are
always welcome!</p>
+<p>The Burr community appreciates all contributions, big and small.</p>
+</section>
</section>
</section>
@@ -463,12 +779,12 @@ of the Burr library and where you can go to learn more
about them:</p>
<footer>
<div class="related-pages">
- <a class="next-page" href="../../examples/">
+ <a class="next-page" href="../up-next/">
<div class="page-info">
<div class="context">
<span>Next</span>
</div>
- <div class="title">Cookbook</div>
+ <div class="title">Next Steps</div>
</div>
<svg class="furo-related-icon"><use
href="#svg-arrow-right"></use></svg>
</a>
@@ -526,14 +842,52 @@ of the Burr library and where you can go to learn more
about them:</p>
<div class="toc-tree-container">
<div class="toc-tree">
<ul>
-<li><a class="reference internal" href="#">Next Steps</a><ul>
-<li><a class="reference internal"
href="#telemetry-ui-chatbot-demo-demo-chatbot">Telemetry UI chatbot demo <code
class="docutils literal notranslate"><span
class="pre">demo_chatbot</span></code></a></li>
-<li><a class="reference internal" href="#repository-examples">Repository
Examples</a><ul>
-<li><a class="reference internal" href="#simple-counter-demo-counter">Simple
Counter <code class="docutils literal notranslate"><span
class="pre">demo_counter</span></code></a></li>
-<li><a class="reference internal"
href="#interactive-rag-demo-conversational-rag">Interactive RAG <code
class="docutils literal notranslate"><span
class="pre">demo_conversational-rag</span></code></a></li>
+<li><a class="reference internal" href="#">Claude Code Skill</a><ul>
+<li><a class="reference internal" href="#what-is-the-claude-code-skill">What
is the Claude Code Skill?</a></li>
+<li><a class="reference internal" href="#installation">Installation</a><ul>
+<li><a class="reference internal"
href="#option-1-install-from-github-easiest">Option 1: Install from GitHub
(Easiest)</a></li>
+<li><a class="reference internal"
href="#option-2-manual-personal-installation">Option 2: Manual Personal
Installation</a></li>
+<li><a class="reference internal"
href="#option-3-manual-project-installation">Option 3: Manual Project
Installation</a></li>
+<li><a class="reference internal" href="#verify-installation">Verify
Installation</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#usage">Usage</a><ul>
+<li><a class="reference internal" href="#manual-invocation">Manual
Invocation</a></li>
+<li><a class="reference internal" href="#automatic-invocation">Automatic
Invocation</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#what-can-it-do">What Can It
Do?</a><ul>
+<li><a class="reference internal" href="#code-generation">Code
Generation</a></li>
+<li><a class="reference internal" href="#code-review">Code Review</a></li>
+<li><a class="reference internal" href="#learning-examples">Learning &
Examples</a></li>
+<li><a class="reference internal" href="#debugging-help">Debugging
Help</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#skill-contents">Skill Contents</a><ul>
+<li><a class="reference internal" href="#api-reference">API Reference</a></li>
+<li><a class="reference internal" href="#examples">Examples</a></li>
+<li><a class="reference internal" href="#design-patterns">Design
Patterns</a></li>
+<li><a class="reference internal"
href="#troubleshooting">Troubleshooting</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#common-use-cases">Common Use
Cases</a><ul>
+<li><a class="reference internal" href="#building-a-chatbot">Building a
Chatbot</a></li>
+<li><a class="reference internal" href="#adding-features">Adding
Features</a></li>
+<li><a class="reference internal" href="#debugging">Debugging</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#tips-for-best-results">Tips for Best
Results</a></li>
+<li><a class="reference internal" href="#example-conversation">Example
Conversation</a></li>
+<li><a class="reference internal"
href="#integration-with-development">Integration with Development</a></li>
+<li><a class="reference internal" href="#customizing-the-skill">Customizing
the Skill</a></li>
+<li><a class="reference internal" href="#updating-the-skill">Updating the
Skill</a></li>
+<li><a class="reference internal" href="#related-resources">Related
Resources</a></li>
+<li><a class="reference internal" href="#faq">FAQ</a></li>
+<li><a class="reference internal" href="#contributing">Contributing</a><ul>
+<li><a class="reference internal" href="#reporting-issues">Reporting
Issues</a></li>
+<li><a class="reference internal"
href="#contributing-improvements">Contributing Improvements</a></li>
</ul>
</li>
-<li><a class="reference internal" href="#understanding-concepts">Understanding
Concepts</a></li>
</ul>
</li>
</ul>
diff --git a/content/getting_started/index.html
b/content/getting_started/index.html
index fcc46ed2..87237993 100644
--- a/content/getting_started/index.html
+++ b/content/getting_started/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal" href="why-burr/">Why
Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal" href="up-next/">Next
Steps</a></li>
</ul>
</li>
@@ -407,6 +408,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l1"><a class="reference internal" href="why-burr/">Why
Burr?</a></li>
<li class="toctree-l1"><a class="reference internal"
href="install/">Installation</a></li>
<li class="toctree-l1"><a class="reference internal"
href="simple-example/">Quickstart</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l1"><a class="reference internal" href="up-next/">Next
Steps</a></li>
</ul>
</div>
diff --git a/content/getting_started/install/index.html
b/content/getting_started/install/index.html
index cde1fb06..ccb003c1 100644
--- a/content/getting_started/install/index.html
+++ b/content/getting_started/install/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal" href="../why-burr/">Why
Burr?</a></li>
<li class="toctree-l2 current current-page"><a class="current reference
internal" href="#">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal" href="../up-next/">Next
Steps</a></li>
</ul>
</li>
diff --git a/content/getting_started/simple-example/index.html
b/content/getting_started/simple-example/index.html
index 824c298a..4112cd84 100644
--- a/content/getting_started/simple-example/index.html
+++ b/content/getting_started/simple-example/index.html
@@ -22,7 +22,7 @@
<head><meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="color-scheme" content="light dark"><meta name="viewport"
content="width=device-width, initial-scale=1" />
-<link rel="index" title="Index" href="../../genindex/"><link rel="search"
title="Search" href="../../search/"><link rel="next" title="Next Steps"
href="../up-next/"><link rel="prev" title="Installation" href="../install/">
+<link rel="index" title="Index" href="../../genindex/"><link rel="search"
title="Search" href="../../search/"><link rel="next" title="Claude Code Skill"
href="../claude-skill/"><link rel="prev" title="Installation"
href="../install/">
<link rel="canonical"
href="https://burr.staged.apache.org/getting_started/simple-example/";>
<link rel="shortcut icon" href="../../_static/favicon.ico"><!-- Generated
with Sphinx 8.2.3 and Furo 2025.12.19 -->
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal" href="../why-burr/">Why
Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../install/">Installation</a></li>
<li class="toctree-l2 current current-page"><a class="current reference
internal" href="#">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal" href="../up-next/">Next
Steps</a></li>
</ul>
</li>
@@ -579,12 +580,12 @@ and his reputation was tarnished by suspicions of treason
and conspiracy.
<footer>
<div class="related-pages">
- <a class="next-page" href="../up-next/">
+ <a class="next-page" href="../claude-skill/">
<div class="page-info">
<div class="context">
<span>Next</span>
</div>
- <div class="title">Next Steps</div>
+ <div class="title">Claude Code Skill</div>
</div>
<svg class="furo-related-icon"><use
href="#svg-arrow-right"></use></svg>
</a>
diff --git a/content/getting_started/up-next/index.html
b/content/getting_started/up-next/index.html
index 9a5513d3..da490a12 100644
--- a/content/getting_started/up-next/index.html
+++ b/content/getting_started/up-next/index.html
@@ -22,7 +22,7 @@
<head><meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="color-scheme" content="light dark"><meta name="viewport"
content="width=device-width, initial-scale=1" />
-<link rel="index" title="Index" href="../../genindex/"><link rel="search"
title="Search" href="../../search/"><link rel="next" title="Cookbook"
href="../../examples/"><link rel="prev" title="Quickstart"
href="../simple-example/">
+<link rel="index" title="Index" href="../../genindex/"><link rel="search"
title="Search" href="../../search/"><link rel="next" title="Cookbook"
href="../../examples/"><link rel="prev" title="Claude Code Skill"
href="../claude-skill/">
<link rel="canonical"
href="https://burr.staged.apache.org/getting_started/up-next/";>
<link rel="shortcut icon" href="../../_static/favicon.ico"><!-- Generated
with Sphinx 8.2.3 and Furo 2025.12.19 -->
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal" href="../why-burr/">Why
Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2 current current-page"><a class="current reference
internal" href="#">Next Steps</a></li>
</ul>
</li>
@@ -472,14 +473,14 @@ of the Burr library and where you can go to learn more
about them:</p>
</div>
<svg class="furo-related-icon"><use
href="#svg-arrow-right"></use></svg>
</a>
- <a class="prev-page" href="../simple-example/">
+ <a class="prev-page" href="../claude-skill/">
<svg class="furo-related-icon"><use
href="#svg-arrow-right"></use></svg>
<div class="page-info">
<div class="context">
<span>Previous</span>
</div>
- <div class="title">Quickstart</div>
+ <div class="title">Claude Code Skill</div>
</div>
</a>
diff --git a/content/getting_started/why-burr/index.html
b/content/getting_started/why-burr/index.html
index 30c07660..b06b0368 100644
--- a/content/getting_started/why-burr/index.html
+++ b/content/getting_started/why-burr/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2 current current-page"><a class="current reference
internal" href="#">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal" href="../up-next/">Next
Steps</a></li>
</ul>
</li>
diff --git a/content/index.html b/content/index.html
index e5cd871f..bac2772a 100644
--- a/content/index.html
+++ b/content/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/main/index.html b/content/main/index.html
index bf762c19..73ee759d 100644
--- a/content/main/index.html
+++ b/content/main/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/objects.inv b/content/objects.inv
index ad74c295..043285da 100644
Binary files a/content/objects.inv and b/content/objects.inv differ
diff --git a/content/py-modindex/index.html b/content/py-modindex/index.html
index 3113f699..1c00b406 100644
--- a/content/py-modindex/index.html
+++ b/content/py-modindex/index.html
@@ -243,6 +243,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/actions/index.html
b/content/reference/actions/index.html
index 0416cc69..8ff378ab 100644
--- a/content/reference/actions/index.html
+++ b/content/reference/actions/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/application/index.html
b/content/reference/application/index.html
index 746b61f6..d2ab2c0a 100644
--- a/content/reference/application/index.html
+++ b/content/reference/application/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/conditions/index.html
b/content/reference/conditions/index.html
index 96f0cd79..1df89f96 100644
--- a/content/reference/conditions/index.html
+++ b/content/reference/conditions/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/index.html b/content/reference/index.html
index 56906e0f..2666b3e0 100644
--- a/content/reference/index.html
+++ b/content/reference/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/integrations/hamilton/index.html
b/content/reference/integrations/hamilton/index.html
index a1615dba..7991b574 100644
--- a/content/reference/integrations/hamilton/index.html
+++ b/content/reference/integrations/hamilton/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/integrations/haystack/index.html
b/content/reference/integrations/haystack/index.html
index 674babd2..1b34dd1d 100644
--- a/content/reference/integrations/haystack/index.html
+++ b/content/reference/integrations/haystack/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/integrations/index.html
b/content/reference/integrations/index.html
index f2036239..1ee4225d 100644
--- a/content/reference/integrations/index.html
+++ b/content/reference/integrations/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/integrations/langchain/index.html
b/content/reference/integrations/langchain/index.html
index 06183d81..ff23a02e 100644
--- a/content/reference/integrations/langchain/index.html
+++ b/content/reference/integrations/langchain/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/integrations/opentelemetry/index.html
b/content/reference/integrations/opentelemetry/index.html
index 0b8054be..4da89e96 100644
--- a/content/reference/integrations/opentelemetry/index.html
+++ b/content/reference/integrations/opentelemetry/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/integrations/pydantic/index.html
b/content/reference/integrations/pydantic/index.html
index 2fadae7b..7c314693 100644
--- a/content/reference/integrations/pydantic/index.html
+++ b/content/reference/integrations/pydantic/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/integrations/ray/index.html
b/content/reference/integrations/ray/index.html
index d4870065..adecb3f8 100644
--- a/content/reference/integrations/ray/index.html
+++ b/content/reference/integrations/ray/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/integrations/streamlit/index.html
b/content/reference/integrations/streamlit/index.html
index 7a02e455..42e23b02 100644
--- a/content/reference/integrations/streamlit/index.html
+++ b/content/reference/integrations/streamlit/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/integrations/traceloop/index.html
b/content/reference/integrations/traceloop/index.html
index ccecd214..be849e1f 100644
--- a/content/reference/integrations/traceloop/index.html
+++ b/content/reference/integrations/traceloop/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/lifecycle/index.html
b/content/reference/lifecycle/index.html
index aac387cf..750a5466 100644
--- a/content/reference/lifecycle/index.html
+++ b/content/reference/lifecycle/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/parallelism/index.html
b/content/reference/parallelism/index.html
index 1bc3ac6c..64abe82f 100644
--- a/content/reference/parallelism/index.html
+++ b/content/reference/parallelism/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/persister/index.html
b/content/reference/persister/index.html
index 83e5c7cb..fd00fce1 100644
--- a/content/reference/persister/index.html
+++ b/content/reference/persister/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/serde/index.html
b/content/reference/serde/index.html
index 2907cfa9..284949a5 100644
--- a/content/reference/serde/index.html
+++ b/content/reference/serde/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/state/index.html
b/content/reference/state/index.html
index cb2ebef9..d942eff4 100644
--- a/content/reference/state/index.html
+++ b/content/reference/state/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/tracking/index.html
b/content/reference/tracking/index.html
index d45463fb..6630fd1d 100644
--- a/content/reference/tracking/index.html
+++ b/content/reference/tracking/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/typing/index.html
b/content/reference/typing/index.html
index 8ce0a9f2..4f03ab99 100644
--- a/content/reference/typing/index.html
+++ b/content/reference/typing/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/reference/visibility/index.html
b/content/reference/visibility/index.html
index 8fc39f53..b8d49e38 100644
--- a/content/reference/visibility/index.html
+++ b/content/reference/visibility/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/search/index.html b/content/search/index.html
index ea7e2bfc..2f43954a 100644
--- a/content/search/index.html
+++ b/content/search/index.html
@@ -245,6 +245,7 @@ s=d.getElementsByTagName('script')[0];
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/why-burr/">Why Burr?</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/install/">Installation</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/simple-example/">Quickstart</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../getting_started/claude-skill/">Claude Code Skill</a></li>
<li class="toctree-l2"><a class="reference internal"
href="../getting_started/up-next/">Next Steps</a></li>
</ul>
</li>
diff --git a/content/searchindex.js b/content/searchindex.js
index 1d0d87e0..2a5422fe 100644
--- a/content/searchindex.js
+++ b/content/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"1. Agent application is modeled as State +
Actions \u2013>
Graph":[[28,"agent-application-is-modeled-as-state-actions-graph"]],"1. Make
your methods async":[[6,"make-your-methods-async"]],"2. Build application
\u2013> built in checkpointing &
tracking":[[28,"build-application-built-in-checkpointing-tracking"]],"2.
Implement the is_async method":[[6,"implement-the-is-async-method"]],"3. Comes
with a UI":[[28,"comes-with-a-ui"]],"3. Use async persisters with [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"1. Agent application is modeled as State +
Actions \u2013>
Graph":[[28,"agent-application-is-modeled-as-state-actions-graph"]],"1. Make
your methods async":[[6,"make-your-methods-async"]],"2. Build application
\u2013> built in checkpointing &
tracking":[[28,"build-application-built-in-checkpointing-tracking"]],"2.
Implement the is_async method":[[6,"implement-the-is-async-method"]],"3. Comes
with a UI":[[28,"comes-with-a-ui"]],"3. Use async persisters with [...]
\ No newline at end of file
diff --git a/content/sitemap.xml b/content/sitemap.xml
index fb8eae32..96f90710 100644
--- a/content/sitemap.xml
+++ b/content/sitemap.xml
@@ -1,2 +1,2 @@
<?xml version='1.0' encoding='utf-8'?>
-<urlset
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";><url><loc>https://burr.staged.apache.org/asf/</loc></url><url><loc>https://burr.staged.apache.org/concepts/actions/</loc></url><url><loc>https://burr.staged.apache.org/concepts/additional-visibility/</loc></url><url><loc>https://burr.staged.apache.org/concepts/hooks/</loc></url><url><loc>https://burr.staged.apache.org/concepts/</loc></url><url><loc>https://burr.staged.apache.org/concepts/overview/</loc></url><url><loc>https://bu
[...]
\ No newline at end of file
+<urlset
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";><url><loc>https://burr.staged.apache.org/asf/</loc></url><url><loc>https://burr.staged.apache.org/concepts/actions/</loc></url><url><loc>https://burr.staged.apache.org/concepts/additional-visibility/</loc></url><url><loc>https://burr.staged.apache.org/concepts/hooks/</loc></url><url><loc>https://burr.staged.apache.org/concepts/</loc></url><url><loc>https://burr.staged.apache.org/concepts/overview/</loc></url><url><loc>https://bu
[...]
\ No newline at end of file
