Skip to content

Add provider-registry skill#148

Draft
kaxil wants to merge 1 commit intomainfrom
add-registry-skill
Draft

Add provider-registry skill#148
kaxil wants to merge 1 commit intomainfrom
add-registry-skill

Conversation

@kaxil
Copy link
Collaborator

@kaxil kaxil commented Mar 2, 2026

Adds a Claude Code skill for the af registry CLI commands (added in #145). The skill auto-activates when editing registry.py or its tests, giving Claude context about the registry API, commands, caching, and response shapes.

Skill structure

.claude/skills/provider-registry/
├── SKILL.md            — Overview, commands, architecture, jq examples
├── api-endpoints.md    — All registry endpoints with response shapes
└── caching.md          — Cache location, TTL strategy, implementation guide

What it provides to agents

  • Commands reference — all four af registry commands with options
  • API endpoints — full endpoint table mapping CLI commands to URLs
  • Response shapes — JSON structure for each endpoint (providers, modules, parameters, connections)
  • Caching details — TTL strategy (1h latest vs 30d versioned), cache location, how to add new cached commands
  • jq examples — filtering by module type, extracting parameters, listing connection types

Skill with three files:
- SKILL.md — overview, commands, architecture, quick reference
- api-endpoints.md — registry API endpoints and response shapes
- caching.md — cache location, TTL strategy, implementation details

Activated when editing registry.py or its tests via glob matching.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant