skill CX Codex

skill-authoring-workflow — Claude Code skill: author repo skills

Q: How do I install skill-authoring-workflow in Claude Code?

Run `npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a claude-code`. The skill file lands at `~/.claude/skills/skill-authoring-workflow/SKILL.md`.

Q: What does the skill need to run?

The repo scripts: `find-a-skill.sh`, `add-a-skill.sh`, `build-a-skill.sh`, `test-a-skill.sh`, `check-skill-metadata.py`. The metadata check runs on `python3`.

Walks a skill from rough notes to a SKILL.md that passes the repo's checks. Useful when you add or update skills in Product-Manager-Skills.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a claude-code

Open on GitHub

What skill-authoring-workflow does

The workflow runs in six phases. It starts with a duplicate search via scripts/find-a-skill.sh, then you pick a type: component, interactive, or workflow. Draft generation comes next — scripts/add-a-skill.sh when source material exists, scripts/build-a-skill.sh when you only have an idea.

Validation is strict. Run scripts/test-a-skill.sh --skill <skill-name> --smoke, then python3 scripts/check-skill-metadata.py skills/<skill-name>/SKILL.md and python3 scripts/check-skill-triggers.py. Metadata has hard limits: name up to 64 characters, description up to 200. The description has to cover both what the skill does and when to reach for it. The Input section needs an example invocation and an instruction telling the agent to reuse whatever the user already supplied instead of asking again.

Adding a skill means editing the README tables and category totals too, or the catalog stops matching reality. Packaging for a Claude custom skill upload goes through scripts/zip-a-skill.sh, which also takes presets such as core-pm. Guided conversations follow the workshop-facilitation protocol, though this file's workflow logic wins on conflicts.

What it helps with

turn workshop notes into a finished skill
update an existing skill without breaking repo standards
run metadata and trigger checks before committing
choose between component, interactive and workflow types
build a zip package of a skill for upload

Example prompts for the agent

Use skill-authoring-workflow: convert research/pricing-workshop-notes.md into an interactive advisor skill.
Run skill-authoring-workflow and validate the new skill's metadata before I commit.
Go through skill-authoring-workflow to update an existing skill and fix the README counts.

How to install skill-authoring-workflow

1Skills CLI (Vercel)

npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a claude-code

2Manually: put the files in place

~/.claude/skills/skill-authoring-workflow/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/skill-authoring-workflow/

1Skills CLI (Vercel)

npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a codex

2Manually: put the files in place

.agents/skills/skill-authoring-workflow/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a cursor

2Manually: put the files in place

.cursor/skills/skill-authoring-workflow/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install deanpeters/Product-Manager-Skills skill-authoring-workflow

2Manually: put the files in place

.github/skills/skill-authoring-workflow/SKILL.md

1Skills CLI (Vercel)

npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a gemini-cli

2Platform CLI

gemini skills install https://github.com/deanpeters/Product-Manager-Skills --path skills/skill-authoring-workflow

Manually: put the files in place

.devin/skills/skill-authoring-workflow/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about skill-authoring-workflow

How do I install skill-authoring-workflow in Claude Code?

Run npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a claude-code. The skill file lands at ~/.claude/skills/skill-authoring-workflow/SKILL.md.

What does skill-authoring-workflow do?

It drives skill creation or updates through phases: overlap search, draft generation, manual tightening, strict validation, and repo documentation updates.

What does the skill need to run?

The repo scripts: find-a-skill.sh, add-a-skill.sh, build-a-skill.sh, test-a-skill.sh, check-skill-metadata.py. The metadata check runs on python3.

setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set73

saas-economics-efficiency-metrics Evaluates SaaS unit economics and capital efficiency metrics like CAC, LTV, and runway. Helpful for product teams deciding whether to scale or optimize. CX Codex +1 2,300installs proto-persona Build a working profile of a target user from research, market signals, and team knowledge. Use it to align early product decisions before deeper validation. CX Codex +1 2,300installs workshop-facilitation A protocol for running interactive sessions: one question per turn, progress labels, and a choice of entry mode. Useful when a workshop keeps drifting. CX Codex +1 2,300installs user-story-mapping-workshop Guides interactive story mapping workshops through adaptive prompts. Organizes workflows into horizontal narrative activities and vertical priority tiers. CX Codex +1 2,200installs recommendation-canvas Evaluates AI product proposals across business goals, PESTEL threats, and solution hypotheses. Built for product managers defending new AI initiatives before leadership. CX Codex +1 2,100installs vp-cpo-readiness-advisor Coaching for the jump from Director to VP or CPO: getting ready, interviewing, the first months in the seat, and fixing what stopped working. CX Codex +1 2,000installs product-sense-interview-answer Guides practice for spoken product-sense interview answers, from framing assumptions to selecting an MVP. Use it for product design, improvement, or build-next prompts. CX Codex +1 1,700installs organic-growth-advisor A skill that runs a quick triage and points to one organic growth path: new segments, geographies, channels or products. CX Codex +1 1,500installs