DevEx Kit
This page is the long guide. The repo README stays short: what you need, how to install, how to start. Source: github.com/saif-shines/devex-kit.
What it is
A set of agent skills for documentation, SDKs, CLIs, MCP servers, and developer go-to-market. You install a plugin or one skill, then type a slash command. The agent follows that skill.
The kit is generic. Scalekit-only docs work lives in
skillkit docs-engineering: agent-connector pages, generated sync, and CODEOWNERS escalation.
How to start
Type /ask-devex and state the job. The human starts this skill. The model does not.
/ask-devex I need to design first-success DX and then write the getting-started docs The router names the next skill and gives a command you can paste.
Three skills are user-started: ask-devex, docs-contribution-router, create-skill. The rest may start from a description match.
Install options
Claude Code
/plugin marketplace add saif-shines/devex-kit
/plugin install tooling@devex-kit
/plugin install documentation@devex-kit
/plugin install dev-gtm@devex-kit tooling includes the router. Install that one first if you are unsure.
Any agent
npx skills add saif-shines/devex-kit --yes
npx skills add saif-shines/devex-kit --skill ask-devex --yes
npx skills add saif-shines/devex-kit --list Do not install a name from in-progress/.
Local clone
git clone https://github.com/saif-shines/devex-kit
/skills load ./plugins/tooling/skills/ask-devex/SKILL.md Every shipped skill path is plugins/<plugin>/skills/<name>/SKILL.md.
Tiles
Each skill still has a tile.json. Tessl is not a first-class install path.
Do not treat tessl as the default.
The three plugins
- documentation: where a page goes, writing style, cookbooks, sidebar labels
- tooling: router, SDKs, CLIs, MCP servers, skills, plugins, code style
- dev-gtm: launch stories and first-success DX
The live human table is in the repo: docs/skills.md.
Example commands
/docs-contribution-router Where does this customer issue go?
/docs-writing-style review mode. [paste draft]
/authoring-cookbooks Readers say this cookbook is hard to follow
/journey-sidebar-labels Reorder this sidebar as an implementation journey
/sdk-craft Design the public API for our TypeScript SDK
/devrel-tooling Build a CLI that scaffolds new projects. Node.js, commander
/mcp-server-craft Design tool schemas for our search API
/create-skill Turn this release checklist into a skill
/devrel-story-craft review mode. Here is a draft launch story
/devrel-dx-craft plan first-success. Choose Sample Application vs Recipe vs Pattern Adapt a docs site
Optional files in the docs repo:
.devex-kit/placement-map.jsonfor the contribution router.devex-kit/style-prompt-block.mdfor writing style
The skill uses those files when they exist. Do not put Scalekit connector or escalation maps in this kit.
Change the kit
Read CLAUDE.md first. It is the same file as AGENTS.md.
Drafts go in in-progress/. A skill is not shipped until the promotion checklist is done.
npm test
npm run check
npm run changeset
npm run version
dora review plugins/<plugin>/skills/<name> --quick If dora is missing, use npx @hacksmith/doraval.