Write a Skill

Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.

57 stars 5 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add javimosch/supercli --skill write-a-skill
Manual install
git clone --depth 1 https://github.com/javimosch/supercli.git /tmp/supercli
mkdir -p ~/.claude/skills
cp -r /tmp/supercli/.agents/skills/write-a-skill ~/.claude/skills/write-a-skill

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Writing Skills

## Process

1. **Gather requirements** - ask user about:
   - What task/domain does the skill cover?
   - What specific use cases should it handle?
   - Does it need executable scripts or just instructions?
   - Any reference materials to include?

2. **Draft the skill** - create:
   - SKILL.md with concise instructions
   - Additional reference files if content exceeds 500 lines
   - Utility scripts if deterministic operations needed

3. **Review with user** - present draft and ask:
   - Does this cover your use cases?
   - Anything missing or unclear?
   - Should any section be more/less detailed?

## Skill Structure

```
skill-name/
├── SKILL.md           # Main instructions (required)
├── REFERENCE.md       # Detailed docs (if needed)
├── EXAMPLES.md        # Usage examples (if needed)
└── scripts/           # Utility scripts (if needed)
    └── helper.js
```

## SKILL.md Template

```md
---
name: skill-name
description: Brief description of capability. Use when [specific triggers].
---

# Skill Name

## Quick start

[Minimal working example]

## Workflows

[Step-by-step processes with checklists for complex tasks]

## Advanced features

[Link to separate files: See [REFERENCE.md](REFERENCE.md)]
```

## Description Requirements
Read the full skill on GitHub

Details

Skill name
write-a-skill
Path
.agents/skills/write-a-skill/SKILL.md
License
MIT
Repo updated
2 November 2026

FAQ

What does the Write a Skill skill do?

Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.

How do I install the Write a Skill skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add javimosch/supercli --skill write-a-skill. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Write a Skill popular?

It lives in javimosch/supercli, which has 57 GitHub stars and 5 forks, and is included in 1 curated skill list.

Related skills

100 Exercises to Learn Rust

57

javimosch/supercli

Use this skill when the user wants to use 100-exercises-to-learn-rust.

Learning & EducationIn 1 list

2to3

57

javimosch/supercli

Use this skill when the user wants to use 2to3, cli tool: 2to3.

Software DevelopmentIn 1 list

2to3 2.7

57

javimosch/supercli

Use this skill when the user wants to use 2to3-2.7, cli tool: 2to3-2.7.

Software DevelopmentIn 1 list

Markdown Report Writing

43

NeuroAIHub/awesome_cognitive_and_neuroscience_skills

Guide AI agents to write beautifully formatted, well-illustrated Markdown reports with proper structure, diagrams, and compatibility across GitHub and Obsidian. Use this skill whenever the user asks you to write a report, project documentation, experiment report, README, technical document, or any long-form Markdown content. Also trigger when users mention Markdown formatting, Mermaid diagrams, report templates, or document publishing.

Writing & Content

Supercli Docs Dev

57

javimosch/supercli

Use this skill when working on supercli documentation — editing docs/index.html, docs/plugins.html, creating scripts that generate doc data (meta-plugins.json), or aligning docs to current implementation. Covers the docs structure, terminology conventions, script patterns, and beads issue workflow.

Writing & ContentIn 1 list

Unity Async Patterns

40

Nice-Wolf-Studio/unity-claude-skills

Unity async and coroutine correctness patterns. Catches common mistakes with Awaitable double-await, missing cancellation tokens, thread context after BackgroundThreadAsync, coroutine error swallowing, batch mode WaitForEndOfFrame, and Addressables handle leaks. PATTERN format: WHEN/WRONG/RIGHT/GOTCHA. Based on Unity 6.3 LTS documentation.

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.