Skill Writer

Guide users through creating, updating, debugging, and validating Agent Skills for AI agents. Use when the user wants to create, write, author, design, troubleshoot, validate, or improve a Skill, or needs help with SKILL.md, frontmatter, or skill structure.

2,187 stars 228 forksSkill & Plugin Authoring

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add lessweb/deepcode-cli --skill skill-writer
Manual install
git clone --depth 1 https://github.com/lessweb/deepcode-cli.git /tmp/deepcode-cli
mkdir -p ~/.claude/skills
cp -r /tmp/deepcode-cli/packages/core/templates/skills/bundled/skill-writer ~/.claude/skills/skill-writer

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

From the SKILL.md

# Skill Writer

This Skill helps you create well-structured Agent Skills for AI agents that follow best practices and validation requirements.

## When to use this Skill

Use this Skill when:

- Creating a new Agent Skill
- Writing or updating SKILL.md files
- Designing skill structure and frontmatter
- Troubleshooting skill discovery issues
- Converting existing prompts or workflows into Skills

## Instructions

### Step 1: Determine Skill scope

First, understand what the Skill should do:

1. **Ask clarifying questions**:
   - What specific capability should this Skill provide?
   - When should AI agents use this Skill?
   - What tools or resources does it need?
   - Is this for personal use or team sharing?

2. **Keep it focused**: One Skill = one capability
   - Good: "PDF form filling", "Excel data analysis"
   - Too broad: "Document processing", "Data tools"

### Step 2: Choose Skill location

Determine where to create the Skill:

**Personal Skills** (`~/.agents/skills/`):

- Individual workflows and preferences
- Experimental Skills
- Personal productivity tools

**Project Skills** (`.agents/skills/`):

- Team workflows and conventions
- Project-specific expertise
- Shared utilities (committed to git)

### Step 3: Create Skill structure

Create the directory and files:

```bash
# Personal
mkdir -p ~/.agents/skills/skill-name

# Project
mkdir -p .agents/skills/skill-name
```

For multi-file Skills:
Read the full skill on GitHub

Details

Skill name
skill-writer
Path
packages/core/templates/skills/bundled/skill-writer/SKILL.md
License
MIT
Repo updated
13 November 2026

FAQ

What does the Skill Writer skill do?

Guide users through creating, updating, debugging, and validating Agent Skills for AI agents. Use when the user wants to create, write, author, design, troubleshoot, validate, or improve a Skill, or needs help with SKILL.md, frontmatter, or skill structure.

How do I install the Skill Writer skill?

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

Is Skill Writer popular?

It lives in lessweb/deepcode-cli, which has 2,187 GitHub stars and 228 forks.

Related skills

Deepcode Self Refer

2.2k

lessweb/deepcode-cli

Answers questions about Deep Code CLI itself — including features, configuration options, slash commands, Skills, MCP integration, permissions, notifications, session persistence, and troubleshooting. Use this when users ask how to configure or use Deep Code, how to set up an MCP server, configure notifications (such as Slack/Feishu), manage permissions, view available skills, understand slash commands, configure thinking mode, etc.

Software Development228

Image Generator

2.2k

lessweb/deepcode-cli

Generate or edit images from text and local files, image URLs, or data URLs through image API. Use when the user asks to create an image, generate from one or more reference images, combine styles or elements across references, or edit a marked region while blending the result into the original scene.

Images, Video & Audio228

Skill Digester

2.2k

lessweb/deepcode-cli

Reviews and improves another DeepCode skill's SKILL.md description field, and guides Agent Skill installation into user or project .agents/skills roots. Use when the user asks to digest a skill, install an Agent Skill, install a skill to user/project scope, or says "消化技能" or "安装 agent skill".

AI, LLMs & Agents228

Skill Creator

2.2k

mrgoonie/claudekit-skills

Create or update Claude skills. Use for new skills, skill references, skill scripts, optimizing existing skills, extending Claude's capabilities.

Skill & Plugin Authoring418

Writing Skills

3.3k

rpamis/comet

Use when creating new skills, editing existing skills, or verifying skills work before deployment

Skill & Plugin Authoring317

<phase or Classification Skill Name>

819

product-on-purpose/pm-skills

<single-line 20-100 word description; include trigger keywords and do not use folded YAML>

Skill & Plugin AuthoringIn 2 lists104

Browse the most popular Claude skills, all skill & plugin authoring skills, or write your own with the skills generator.