skill-writing-guide — Claude Code skill: what it does, how to install
skill-writing-guide guides the creation and refinement of Claude Code skills. Turns repetitive chat workflows into reusable, properly structured instruction files.
no license ★ 165 updated 2026-08-21
npx skills add aspi6246/Claude-Code-Skills-for-Academics --skill skill-writing-guide -a claude-codeWhat skill-writing-guide does
This skill acts as an authoring reference for Claude Code workflows. It triggers whenever you ask the agent to build, polish, or preserve an interaction pattern as a permanent capability. The guide outlines the required directory structure, centering on a kebab-case folder containing a SKILL.md file with YAML metadata.
The core focus is drafting reliable descriptions. Because agents often fail to invoke vague skills, the text teaches you to include explicit target tool names and edge-case activation phrases. It emphasizes negative constraints and concrete code samples over high-level advice.
When a SKILL.md exceeds roughly 200 lines, the instructions mandate moving extra documentation into a dedicated references/ subfolder. Writing workflows and code review processes must also stay separated into distinct skills.
What it helps with
- build a valid
SKILL.mdfile with matching YAML frontmatter - draft explicit descriptions that trigger reliably during agent sessions
- turn recurring corrections into strict negative constraints
- split oversized instruction files into modular subdirectories
Example prompts for the agent
- Turn this conversation workflow into a reusable skill
- Make this a skill for panel regression analysis
- Help me improve the description and structure of my custom skill
How to install skill-writing-guide
1Skills CLI (Vercel)
npx skills add aspi6246/Claude-Code-Skills-for-Academics --skill skill-writing-guide -a claude-code2Manually: put the files in place
~/.claude/skills/skill-writing-guide/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill-writing-guide/
1Skills CLI (Vercel)
npx skills add aspi6246/Claude-Code-Skills-for-Academics --skill skill-writing-guide -a codex2Manually: put the files in place
.agents/skills/skill-writing-guide/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aspi6246/Claude-Code-Skills-for-Academics --skill skill-writing-guide -a cursor2Manually: put the files in place
.cursor/skills/skill-writing-guide/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aspi6246/Claude-Code-Skills-for-Academics skill-writing-guide2Manually: put the files in place
.github/skills/skill-writing-guide/SKILL.md1Skills CLI (Vercel)
npx skills add aspi6246/Claude-Code-Skills-for-Academics --skill skill-writing-guide -a gemini-cli2Platform CLI
gemini skills install https://github.com/aspi6246/Claude-Code-Skills-for-Academics --path skill-writing-guideManually: put the files in place
.devin/skills/skill-writing-guide/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about skill-writing-guide
How to install skill-writing-guide in Claude Code?
Run npx skills add aspi6246/Claude-Code-Skills-for-Academics --skill skill-writing-guide -a claude-code in your terminal.
What does skill-writing-guide do?
It provides rules and templates for structuring SKILL.md files, drafting trigger descriptions, and testing custom skills across multi-turn prompts.
When should a skill be split according to the guide?
Split the file when SKILL.md exceeds 200 lines, when two workflows only occasionally overlap, or when authoring code is mixed with reviewing code.