Skip to content

feat: consolidate Claude platform skills with multi-platform support #34

@galligan

Description

@galligan

Summary

Consolidate Claude Code extension authoring skills into a claude-plugins plugin with platform-specific guidance via platforms/ subdirectories.

Current State

agent-kit has 8 skills for Claude Code authoring:

  • claude-agent-development
  • claude-plugin-development
  • claude-command-authoring
  • claude-hook-authoring
  • claude-rules-authoring
  • claude-code-configuration
  • codex-configuration
  • skills-development

These are Claude Code-centric but the concepts apply across platforms.

Proposal

New Plugin: claude-plugins

claude-plugins/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    ├── plugins/
    │   ├── SKILL.md           # Core plugin concepts
    │   └── platforms/
    │       ├── claude-code.md  # Claude Code specifics
    │       ├── agent-sdk.md    # Anthropic Agent SDK
    │       └── github-actions.md
    ├── agents/
    │   ├── SKILL.md
    │   └── platforms/
    │       ├── claude-code.md
    │       └── agent-sdk.md
    ├── skills/
    │   ├── SKILL.md
    │   └── platforms/
    │       └── ...
    ├── commands/
    │   ├── SKILL.md
    │   └── platforms/
    │       └── ...
    ├── hooks/
    │   ├── SKILL.md
    │   └── platforms/
    │       └── ...
    └── config/
        ├── SKILL.md
        └── platforms/
            ├── claude-code.md
            └── codex.md

Skill Structure

Each skill has:

  • SKILL.md — Core concepts, universal patterns
  • platforms/ — Platform-specific implementation details
    • claude-code.md — Claude Code CLI specifics
    • agent-sdk.md — Anthropic Agent SDK (Python/TS)
    • github-actions.md — CI/CD integration
    • Others as needed

Benefits

  1. Single source of truth for extension concepts
  2. Platform-aware without duplication
  3. Future-proof — easy to add new platforms
  4. Cleaner namesplugins, agents, hooks vs verbose current names

Tasks

  • Design skill structure with platform subdirs
  • Migrate agent-kit skills to new structure
  • Add Agent SDK platform docs (currently missing)
  • Add GitHub Actions platform docs where relevant
  • Update cross-references from other plugins
  • Deprecate/remove old agent-kit plugin

Open Questions

  • Should codex-configuration stay or be dropped? (Codex CLI relevance?)
  • What other platforms should be covered initially?

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions