Skills Guide

Add Skill

VerifiedSafe

Create and populate a new skill guide for recurring tasks. Guides you through analyzing codebase, gathering context, and structuring a SKILL.md.

Download and use
Sby Skills Guide Bot
DocumentationBeginner
7/22/2026
Claude Code
#skill-authoring#claude-code#codebase-analysis#knowledge-base#meta-skill

Recommended for

Claude CodeAuto documentation

Automated summary

This skill generates a new SKILL.md guide under .claude/skills/ by analyzing the codebase to document a recurring task.

Strengths

  • Grounds the guide in real code by searching the project for existing patterns and examples
  • Asks clarifying questions through AskUserQuestion before writing, avoiding generic boilerplate
  • Produces a complete normalized structure: when to use, steps, anti-patterns, file-located examples, and related links
  • Includes a stop rule after three failed attempts instead of looping indefinitely

Limitations

  • Assumes the codebase already contains illustrative patterns; on a new or empty project the examples will be thin
  • Relies on the AskUserQuestion tool and the .claude/skills/ layout, so it is tied to Claude Code
  • Does not validate the resulting skill: no testing that the guide actually works in practice
When to use it

Use it when a pattern or procedure keeps recurring in the project and deserves a reusable guide grounded in existing code.

When not to use it

Avoid it for one-off tasks or conventions that have no concrete implementation in the codebase yet.

Security analysis

Safe
Quality score82/100

The skill only asks the agent to gather context, search the codebase, create a scoped `.claude/skills/[slug]` directory, and write a documentation file. It includes a benign `mkdir -p` command and no destructive, exfiltration, obfuscation, or safety-disabling instructions.

No concerns found

How this analysis is made

Examples

Document an error-handling pattern
/add-skill error handling for API routes
Capture a testing convention
/add-skill integration testing with the local database
No topic given
/add-skill

description: Create and populate a new skill guide for recurring tasks. argument-hint: "[name or topic]"

Add Skill

Create and populate a new skill guide for recurring tasks.

Usage: /add-skill [name or topic]

Process

1. Get Skill Topic

If $ARGUMENTS is empty, use AskUserQuestion tool to ask:

  • "What task or pattern should this skill document?"

2. Analyze Codebase

Search the codebase to find:

  • Existing patterns related to this skill
  • Code examples that demonstrate the pattern
  • Common files/modules involved

3. Gather Context

Use AskUserQuestion tool to ask 2-3 clarifying questions:

  • When should developers use this pattern?
  • Are there any anti-patterns or common mistakes to avoid?
  • Any project-specific conventions for this task?

4. Create Skill Structure

mkdir -p .claude/skills/[skill-slug]

5. Populate SKILL.md

Create .claude/skills/[skill-slug]/SKILL.md:

# Skill: [Name]

## When to Use

- [Situation 1 - based on analysis]
- [Situation 2]
- [Situation 3]

## Step by Step

### 1. [First Step]

[Explanation]

```[language]
# Code example from this codebase
[actual code found in the project]

2. [Second Step]

[Explanation]

[code example]

3. [Third Step]

[Explanation]

[code example]

Anti-Patterns

Don't:

  • [Bad practice 1 - why it's bad]
  • [Bad practice 2 - why it's bad]

Do:

  • [Good practice 1]
  • [Good practice 2]

Examples from This Codebase

[Example 1 Name]

Located at: [file path]

[relevant code snippet]

[Example 2 Name]

Located at: [file path]

[relevant code snippet]

Related

  • [Link to related ADR if applicable]
  • [Link to related skill if applicable]

## Output

Created: .claude/skills/[slug]/SKILL.md

Skill: [Name]

Steps documented: X Examples included: X from codebase Anti-patterns: X identified


## If You Get Stuck

If you cannot make progress after 3 attempts at the same step:
1. Stop immediately
2. Explain what you're trying to do and what's blocking you
3. **Use AskUserQuestion tool** to ask the user how to proceed

Never loop indefinitely. If you find yourself repeating the same actions without progress, stop and ask for help.

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/add-skill-mrwakelw/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/add-skill-mrwakelw' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/add-skill-mrwakelw/download' --output '.skill-downloads/add-skill-mrwakelw/SKILL.md.part' && mv '.skill-downloads/add-skill-mrwakelw/SKILL.md.part' '.skill-downloads/add-skill-mrwakelw/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

No recognized prerequisites section in this file. This does not mean it is self-contained: libraries, tools and access requirements may be mentioned elsewhere in the content or source repository.

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

This file does not provide a usable name/description header for this native procedure. It remains available to download and inspect; use the manual method below.

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/add-skill-mrwakelw/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills

Supabase Docs Authoring

Documentation

Write, edit, and review Supabase documentation content including guides, tutorials, reference docs, and partials. Follow style guides and MDX/TOML validation rules.

Claude CodeintermediateSafe 108,544
Skills Guide Bot

Create Architecture Decision Record

Documentation

Create a new Architecture Decision Record with sequential numbering, register it in the AgentDB graph, and link related ADRs.

Claude CodeintermediateSafe 69,659
Skills Guide Bot

Plan update with deep research

Documentation

Updates a plan document by launching parallel subagents to analyze a topic across all compiler passes, then consolidates findings into the plan doc.

Claude CodeadvancedSafe 248,015
Skills Guide Bot