feat: Add Claude Skills for Osiris component development#61
Conversation
Add comprehensive Claude Skills infrastructure for third-party component development: Skills: - osiris-component-developer: Complete skill for building Osiris components - SKILL.md: Main skill with YAML frontmatter and workflow - CHECKLIST.md: 57 validation rules - POSTHOG_EXAMPLE.md: Complete PostHog extractor example - TEMPLATES.md: Code templates and common patterns - README.md: Skill documentation - codex: Skill for leveraging OpenAI Codex CLI for second opinions - Supports multi-model validation and structured JSON output Documentation: - docs/reference/COMPONENT_CAPABILITIES_*.md: Component capabilities deep dive - docs/third-party-packaging/*: Complete packaging strategy and guides Structure follows Claude Skills best practices: - YAML frontmatter with name and description - Progressive disclosure (Level 1/2/3 loading) - Skill-specific directories with SKILL.md - Resource files for on-demand loading Enables third-party developers to build production-ready Osiris components in isolated projects with full E2B cloud compatibility and 57-rule validation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| modes: | ||
| - extract # or write, transform, discover | ||
|
|
||
| capabilities: | ||
| - discover | ||
| - healthcheck | ||
|
|
There was a problem hiding this comment.
Documented capabilities format mismatches component schema
The skill’s spec template shows capabilities as a list of strings including a healthcheck entry, but the component schema used by components.registry expects an object of boolean flags (e.g., {discover: true, doctor: true}) and uses doctor as the health check capability. Following this doc will generate specs that fail validation and won’t be recognized by the CLI. Consider documenting the object format and rename the capability to the existing doctor flag.
Useful? React with 👍 / 👎.
Summary
Add comprehensive Claude Skills infrastructure that enables third-party developers to build production-ready Osiris components in isolated projects.
What's New
Claude Skills
osiris-component-developer - Complete skill for building Osiris components:
codex - Skill for multi-model validation:
Documentation
Component Capabilities:
Third-Party Packaging:
Architecture
Follows Claude Skills best practices:
Total: 18 files, ~10k lines
Benefits
How to Use
In any Claude Code instance (including separate projects):
Testing
Skills are validated:
Files Changed
🤖 Generated with Claude Code