Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add aspi6246/Claude-Code-Skills-for-Academics --skill skill-writing-guide -a claude-code
Open on GitHub

What 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.md file 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-code

2Manually: put the files in place

~/.claude/skills/skill-writing-guide/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/skill-writing-guide/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set17

The whole set →
pinboard This skill stores project notes, reminders, and ideas in PINBOARD.md. It can also list entries and move completed tasks to a Done section. CX Codex +1 ★ 165repo stars wtf Rewrites the previous answer in plain language when you did not follow it. Fires on “wtf”, “huh?” or “say that simpler”. CX Codex +1 ★ 165repo stars code-audit code-audit audits empirical R and Python scripts through a two-stage protocol before running computations on research data. CX Codex +1 ★ 165repo stars beamer-slides-teaching beamer-slides-teaching creates teaching decks in LaTeX Beamer using a defined set of layout conventions. Use it for lecture slides, discussion prompts, case studies, or multiple-choice questions. CX Codex +1 ★ 165repo stars r-empirical-finance Sets the R conventions your agent follows for empirical finance work: fixest regressions, DiD and IV models, Parquet loading through arrow, plots in ggplot2. CX Codex +1 ★ 165repo stars paper-editor paper-editor audits academic finance manuscripts across seven editorial stages and verifies revisions for journal submissions or R&R reports. CX Codex +1 ★ 165repo stars edmans-audit edmans-audit is a Claude Code skill that checks a finance paper's LaTeX draft against Alex Edmans' rejection framework before journal submission. CX Codex +1 ★ 165repo stars beamer-check beamer-check compiles a Beamer deck, reviews every rendered slide, then repairs the overflows, broken figures and blank frames it turns up. CX Codex +1 ★ 165repo stars

Project sponsors

Companies that keep this analytics open