skills

Agent skills for Claude Code (and other Agent Skills–compatible harnesses), covering:

Skill What it's for
state-machine-design Recognize a state machine, then design its states, events, guards, actions
changeset-writing Write a changeset: pick the semver bump, write the summary, flag breaking changes
engineering-writing Write an announcement post, a how-we-built-X deep-dive, or a retrospective
component-api-design Design a component's public API: naming, props, compound structure, data-attributes, CSS vars

Status: all four skills have real content.

Install

As a Claude Code plugin:

/plugin marketplace add segunadebayo/design-eng-skills
/plugin install design-eng-skills@segunadebayo

Or symlink individual skills into your local skills directory:

./scripts/link-skills.sh

Repo layout

skills/<skill-name>/SKILL.md       # the skill itself, kept short
skills/<skill-name>/references/    # optional - docs loaded into context as needed
skills/<skill-name>/assets/        # optional - files used in output (templates, etc.)
skills/<skill-name>/scripts/       # optional - executable helper scripts
skills/<skill-name>/agents/        # optional per-harness metadata (e.g. openai.yaml)
.claude-plugin/                    # plugin.json + marketplace.json
scripts/                           # dev-only install/list helpers
.changeset/                        # versioning, via @changesets/cli

Follows the Agent Skills progressive-disclosure convention: SKILL.md stays short and is loaded whenever the skill triggers, everything in references//assets//scripts/ is read only as needed.

Contributing

This repo uses changesets for versioning — run npm run changeset after a change (this is also, fittingly, what the changeset-writing skill is for).