Add New Skill

VerifiedSafe

Creates a new skill file with the required structure, loading style guides and parsing arguments for category, name, and description. Use this when adding a new skill to ensure it follows the standard format and conventions.

Sby Skills Guide Bot
DocumentationIntermediate
6/2/2026
Claude CodeCursor
#skill-creation#template#contribution#catalog

Recommended for

Automated summary

This skill creates a new skill for the curated catalog using a standardized format.

Strengths

  • Provides a structured template for consistent skills
  • Includes verification checklist and anti-patterns
  • References style guides for better documentation

Limitations

  • Requires manual update of the README file
  • Does not automatically create new category directories
  • Does not validate the content of the created skill
When to use it

Use this skill when you need to add a new skill to the curated catalog following the official format.

When not to use it

Do not use this skill for editing existing skills or for content that does not fit the standard template.

Security analysis

Safe
Quality score88/100

The skill only performs file system inspection and creation tasks using safe commands like ls and head, and guides creation of markdown files. There is no network access, no execution of arbitrary code, and no destructive actions.

No concerns found

How this analysis is made

Examples

Add XSS prevention skill
Add a new skill security xss-prevention 'Prevent cross-site scripting attacks in WordPress'
Create a skill for React testing
Add a new skill testing react-testing 'Write unit tests for React components with Jest and React Testing Library'
Add a skill for code formatting
Add a new skill development prettier 'Configure and enforce Prettier code formatting across projects'

Add New Skill

Create a new skill following the standard format.

Arguments

$ARGUMENTS

Expected format: <category> <skill-name> "<one-line description>"

Example: security xss-prevention "Prevent cross-site scripting attacks in WordPress"

Pre-flight Checks

# List existing skill categories
ls -d skills/*/ 2>/dev/null | sed 's/skills\///' | sed 's/\///'

# Show skill format reference
head -30 skills/prompt-engineering/SKILL.md

Instructions

  1. Parse the arguments to get:

    • Category (must be existing directory or create new)
    • Skill name (kebab-case)
    • One-line description
  2. Load style guides first:

    • skills/prompt-engineering/references/anti-patterns.md
    • skills/prompt-engineering/references/wordpress-docs-style-guide.md
  3. Create the skill file at skills/<category>/<skill-name>.md with this structure:

# [Skill Name in Title Case]

> **Topic**: <category>/<skill-name>
> **Platforms**: All
> **Source**: wp-dev-prompts

<skill>
<summary>
[One-line description from arguments]
</summary>

<knowledge>
## Core Concepts

[Essential knowledge - 2-3 paragraphs]

## Best Practices

1. [Practice with explanation]
2. [Practice with explanation]
3. [Practice with explanation]

## Common Patterns

```[language]
[Correct code pattern example]

Anti-Patterns (Avoid)

  • ❌ [What NOT to do and why]
  • ❌ [Another thing to avoid]

Verification Checklist

  • [ ] [How to verify correct implementation]
  • [ ] [Another verification step] </knowledge>
<references> - [Relevant official docs](URL) </references> </skill>

Platform Integration

Claude Code / Cursor / Cline

Reference this skill in prompts or CLAUDE.md.

ChatGPT / Gemini

Copy the <knowledge> section directly into your prompt.


4. Update `skills/README.md`:
   - Add to directory structure if new category
   - Update skill count
   - Add to category description section

5. Verify the skill:
   - Check for AI indicator words
   - Confirm proper markdown formatting
   - Validate internal links

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-new-skill-mm5t8bh1/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-new-skill-mm5t8bh1' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/add-new-skill-mm5t8bh1/download' --output '.skill-downloads/add-new-skill-mm5t8bh1/SKILL.md.part' && mv '.skill-downloads/add-new-skill-mm5t8bh1/SKILL.md.part' '.skill-downloads/add-new-skill-mm5t8bh1/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-new-skill-mm5t8bh1/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