skill-authoring
Create or improve Agent Deck/Pi skills, including where to save them, SKILL.md frontmatter, simple vs modular structure, and validation.
Profile →npx skills add a-streetcoder/agent-deck --skill skill-authoring --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Skill authoring Use this skill when the user wants to create, convert, review, or validate an Agent Deck/Pi skill. ## Choose catalog location and assignment Before creating a new skill, explicitly ask the user whether the skill should be enabled for all projects by default unless they already gave an unambiguous preference. Do not ask whether it is a "personal" skill: Agent Deck treats user-authored skills as catalog resources, then controls runtime use through assignment metadata. For new user-authored skills, create the skill in the normal global Agent Deck/Pi skills catalog: ```text ~/.pi/agent/skills/<skill-name>/SKILL.md ``` Then explain or apply the requested assignment: - Default / All Projects — the skill is injected into parent sessions for every project. - Unassigned catalog skill — the skill is visible in the catalog but is not injected until the user manually assigns it to All Projects, a specific project, or a native agent. - Project assignment — the skill is injected into parent sessions for one project. - Agent assignment — the skill is injected into one native subagent. Do not infer project-local just because the current working directory is a repository. Agent De
- Choose catalog location and assignment
- Basic format
- Simple skill pattern
- Modular skill pattern
- Authoring workflow
- Agent Deck assignment notes
- Validation checklist
What does the skill-authoring skill do?
Create or improve Agent Deck/Pi skills, including where to save them, SKILL.md frontmatter, simple vs modular structure, and validation.
How do I install it?
Run `npx skills add a-streetcoder/agent-deck --skill skill-authoring --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From a-streetcoder/agent-deck, a repository with 88 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.