writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment.
Best use case
writing-skills is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Use when creating new skills, editing existing skills, or verifying skills work before deployment.
Teams using writing-skills should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/writing-skills/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How writing-skills Compares
| Feature / Agent | writing-skills | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Use when creating new skills, editing existing skills, or verifying skills work before deployment.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Writing Skills ## Overview Writing skills IS Test-Driven Development applied to process documentation. Write pressure tests, watch agents fail, write the skill, watch them pass, close loopholes. **Core principle:** If you did not watch an agent fail without the skill, you do not know if the skill teaches the right thing. ## TDD for Skills | TDD Concept | Skill Creation | |-------------|----------------| | Test case | Pressure scenario with subagent | | Production code | Skill document (SKILL.md) | | RED | Agent violates rule without skill | | GREEN | Agent complies with skill present | | REFACTOR | Close loopholes | ## Skill Structure - YAML frontmatter: `name` and `description` only - Description: "Use when..." (triggering conditions only, never summarize workflow) - Flat namespace, separate files only for heavy reference or reusable tools ## Tool Use Meta-skill for creating new skills within the methodology.
Related Skills
tech-writing-lint
Automated technical writing style and quality enforcement. Lint documentation with Vale, check for inclusive language, enforce style guides, and analyze readability metrics.
tech-writing-linter
Lint technical documentation for style, consistency, and readability
academic-writing-publication
Prepare manuscripts following APA, ASA, or discipline-specific guidelines with proper reporting standards and peer review navigation
philosophical-writing-argumentation
Compose clear, rigorous philosophical prose with well-structured arguments, anticipation of objections, and proper scholarly engagement with existing literature
grant-narrative-writing
Compose compelling research narratives for NEH, ACLS, and foundation funding proposals with clear significance statements
learning-objectives-writing
Write measurable, SMART learning objectives using Bloom's Taxonomy cognitive levels aligned with desired outcomes and assessment strategies
interpretive-writing
Create accessible interpretive content for diverse audiences including labels, wall text, catalog essays, educational materials, and digital content
grant-proposal-writing
Develop compelling funding proposals for foundations, government agencies, and corporations including narrative development, budget creation, and compliance documentation
lyric-writing
Write complete song lyrics with structural annotations and production notes optimized for AI music generation platforms like Suno and Udio
treatment-writing
Develop narrative synopses that tell the complete story cinematically, serving as sales documents and production blueprints
scene-writing
Write individual screenplay scenes with proper industry formatting, visual action, and dramatic structure
logline-writing
Craft compelling one-sentence story hooks that capture protagonist, conflict, stakes, and unique appeal for film/TV pitches