Skip to content

Repository files navigation

devtool-skills

Agent Skills for building developer tools. Webhooks, API keys, billing, SDKs, security, and developer growth, for Claude Code and any agent supporting the Agent Skills spec.

Built by Alex Pate (@alexjpate).

What are Skills?

Agent Skills are an open format for giving AI agents specialized knowledge: a folder with a SKILL.md file containing instructions the agent loads when a task matches. Agents read only each skill's name and description at startup, then pull in the full instructions on demand, so a large collection costs almost no context. The format was released by Anthropic as an open standard and works across Claude Code, Cursor, Copilot, Codex, and a growing list of agents.

How skills work together

Run devtool-context once. It interviews you and writes .agents/devtool-context.md, a one-page profile of your product that every other skill reads before doing anything, so recommendations fit your actual API, pricing, and stack.

                        ┌───────────────────┐
                        │  devtool-context  │
                        │  (run this first) │
                        └─────────┬─────────┘
                                  │  writes .agents/devtool-context.md
          ┌───────────────────────┼───────────────────────┐
          ▼                       ▼                       ▼
   Platform                Business & trust        Growth
   engineering                                     engineering
   ─────────────────       ────────────────────    ─────────────────
   webhook-delivery        billing-entitlements    oss-to-hosted
   api-keys                security-page           integration-pages
   sdk-design
   event-taxonomy

Every skill also works standalone; without the context file it asks you two or three targeted questions instead.

Available skills

Skill What it does
devtool-context Creates the one-page product profile every other skill reads first
webhook-delivery Stripe-grade outbound webhooks: signing, envelopes, retries, replay, delivery logs
api-keys Credential design: prefixed keys, hashing at rest, test/live modes, rotation, display-once
sdk-design Typed client ergonomics: constructor config, typed errors, auto-pagination, retries, and what not to add
event-taxonomy One canonical event language: object.verb naming, versioned schemas, registry as code
billing-entitlements Plans as data, a single getEntitlements() gate, usage snapshots, what never to paywall
security-page A credible security page before SOC 2: concrete controls, subprocessors, disclosure policy
oss-to-hosted The open-source → hosted funnel: layer split, honest upsell, telemetry ethics, license choice
integration-pages Programmatic /integrations/[app] pages from a single manifest, without the madlibs

Installation

skills CLI

npx skills add alexpate/devtool-skills

Tip: inside a Claude Code session, npx skills add alexpate/devtool-skills -a claude-code installs them for the current project.

Claude Code plugin

/plugin marketplace add alexpate/devtool-skills
/plugin install devtool-skills@devtool-skills

Clone and copy

git clone https://github.com/alexpate/devtool-skills.git
cp -r devtool-skills/skills/* ~/.claude/skills/   # or your agent's skills directory

Fork

Fork the repo and edit the skills to match your own positions. They're MIT licensed and meant to be argued with.

Usage examples

Once installed, the skills trigger on natural prompts:

You say Skill that fires
"Design webhook delivery for my API" webhook-delivery
"Should webhooks be a paid feature?" billing-entitlements
"Write a security page for my SaaS" security-page
"Structure my open-source to paid funnel" oss-to-hosted

Skill categories

Foundation

  • devtool-context: the product profile the rest of the collection reads

Platform engineering

  • webhook-delivery: outbound event delivery infrastructure
  • api-keys: API credential design
  • sdk-design: typed client ergonomics
  • event-taxonomy: event naming and schema governance

Business & trust

  • billing-entitlements: plans, entitlements, metered billing
  • security-page: trust pages before SOC 2

Growth engineering

  • oss-to-hosted: the open-source to hosted-platform funnel
  • integration-pages: programmatic integration page architecture

For marketing-side skills (copywriting, SEO, ads), see marketingskills. This collection deliberately doesn't duplicate it.

Contributing

Contributions welcome, especially from people who have shipped the thing the skill describes. See CONTRIBUTING.md. The short version: take positions, cite real exemplars, drive toward artifacts, no product placement.

License

MIT

About

A collection of skills for building developer tools

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages