Add Claude Code skill for Burr

.claude/plugins/burr/.claude-plugin/marketplace.json

@@ -0,0 +1,33 @@
+{
+  "name": "Burr Plugin Marketplace",
+  "description": "Official Claude Code plugin for the Apache Burr framework",
+  "version": "1.0.0",
+  "owner": {
+    "name": "Apache Software Foundation",
+    "url": "https://www.apache.org/"
+  },
+  "plugins": [
+    {
+      "name": "burr",
+      "source": "./",
+      "description": "Expert AI assistant for Apache Burr framework development - create state machines, define actions, manage transitions, and build stateful applications",
+      "version": "1.0.0",
+      "author": {
+        "name": "Apache Burr Contributors",
+        "email": "dev@burr.apache.org"
+      },
+      "homepage": "https://burr.apache.org",
+      "repository": "https://github.com/apache/burr",
+      "license": "Apache-2.0",
+      "keywords": [
+        "burr",
+        "state-machine",
+        "llm",
+        "agent",
+        "workflow",
+        "stateful",
+        "python"
+      ]
+    }
+  ]
+}

.claude/plugins/burr/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "burr",
+  "version": "1.0.0",
+  "description": "Expert AI assistant for Apache Burr framework development - create state machines, define actions, manage transitions, and build stateful applications",
+  "author": {
+    "name": "Apache Burr Contributors",
+    "email": "dev@burr.apache.org"
+  },
+  "homepage": "https://burr.apache.org",
+  "repository": "https://github.com/apache/burr",
+  "license": "Apache-2.0",
+  "keywords": [
+    "burr",
+    "state-machine",
+    "llm",
+    "agent",
+    "workflow",
+    "stateful",
+    "python"
+  ],
+  "skills": "./skills/"
+}

.claude/plugins/burr/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to the Apache Burr Claude Code plugin will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-01-31
+
+### Added
+- Initial release of the Apache Burr plugin for Claude Code
+- Comprehensive skill documentation covering:
+  - Core API reference for actions, state machines, and application builders
+  - Common patterns and best practices
+  - Example implementations for various use cases
+  - Troubleshooting guide for common issues
+- Marketplace-ready plugin structure
+- Support for building stateful applications with state machines
+- LLM agent development guidance
+- Observability and tracking integration
+
+### Changed
+- Reorganized plugin structure for marketplace distribution
+- Migrated from flat skill structure to nested plugin/skills format

.claude/plugins/burr/README.md

@@ -0,0 +1,67 @@
+# Apache Burr Plugin for Claude Code
+
+Official Claude Code plugin for the [Apache Burr](https://burr.apache.org) framework.
+
+## Overview
+
+This plugin provides expert AI assistance for building stateful applications using Apache Burr. Get help with state machines, actions, transitions, observability, and LLM agent development.
+
+## Features
+
+- **State Machine Design**: Expert guidance on designing state machines and workflows
+- **Action Development**: Help writing actions with proper state management
+- **Transition Logic**: Assistance with conditional transitions and graph structure
+- **LLM Integration**: Support for building LLM agents and agentic workflows
+- **Observability**: Guidance on tracking, telemetry, and debugging
+- **Best Practices**: Learn common patterns and anti-patterns
+
+## Installation
+
+This plugin is included in the Apache Burr repository at `.claude/plugins/burr/`.
+
+To use it with Claude Code:
+
+1. Ensure you're in a project with the `.claude/plugins/` directory
+2. The plugin will be automatically detected
+3. Use `/burr` to activate the skill
+
+## Usage
+
+Once installed, you can invoke the Burr skill using:
+
+```
+/burr
+```
+
+The skill provides:
+- API reference for core Burr concepts
+- Code examples for common use cases
+- Pattern guidance for stateful applications
+- Troubleshooting help for common issues
+
+## Documentation
+
+The plugin includes comprehensive documentation:
+
+- **SKILL.md**: Main skill instructions and system prompt
+- **api-reference.md**: Complete API documentation
+- **examples.md**: Code examples and use cases
+- **patterns.md**: Best practices and common patterns
+- **troubleshooting.md**: Common issues and solutions
+
+## License
+
+Apache License 2.0 - See the main Burr repository for details.
+
+## Links
+
+- [Burr Documentation](https://burr.apache.org)
+- [GitHub Repository](https://github.com/apache/burr)
+- [Apache Software Foundation](https://www.apache.org/)
+
+## Support
+
+For issues or questions:
+- Open an issue on [GitHub](https://github.com/apache/burr/issues)
+- Check the [documentation](https://burr.apache.org)
+- Review the troubleshooting guide included in this plugin