example-skill

smith6jt-cop's avatarfrom smith6jt-cop

Example skill demonstrating the registry structure and format

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026
[Prompt Templates and Packaging]

When & Why to Use This Skill

This Claude skill serves as a foundational reference template for developers looking to build, package, and organize a skills registry for Claude Code. It provides a standardized framework for directory structures, metadata configuration, and documentation best practices, ensuring that custom agent skills are discoverable, reproducible, and easy to maintain within a professional development workflow.

Use Cases

  • Standardizing Skill Development: Use this template to establish a consistent folder structure and metadata format across a team's custom AI agent skills.
  • Improving Skill Discoverability: Apply the recommended trigger condition patterns in the plugin.json to ensure skills are accurately invoked by the /advise command.
  • Institutional Knowledge Capture: Utilize the 'Failed Attempts' and 'Key Insights' sections to document development hurdles, preventing team members from repeating past mistakes.
  • Automated Validation: Reference the included validation workflow to ensure all plugin metadata is correctly formatted before committing to a shared repository.
nameexample-skill
description"Example skill demonstrating the registry structure and format"
authorSkills Registry Team
date2024-12-10

example-skill - Research Notes

Experiment Overview

Item Details
Date 2024-12-10
Goal Create an example skill to demonstrate the skills registry format
Environment Any system with Claude Code installed
Status Success

Context

When setting up a skills registry, it helps to have a concrete example showing the expected structure and format. This skill serves as that reference.

Verified Workflow

  1. Copy the template folder:
cp -r templates/experiment-skill-template plugins/training/your-skill-name
  1. Rename the skills subdirectory:
mv plugins/training/your-skill-name/skills/TEMPLATE_NAME \
   plugins/training/your-skill-name/skills/your-skill-name
  1. Update plugin.json with your skill's metadata:
{
  "name": "your-skill-name",
  "version": "1.0.0",
  "description": "Specific triggers: (1) when X, (2) when Y",
  "author": { "name": "Your Name" },
  "skills": "./skills",
  "repository": "https://github.com/smith-cop/Skills_Registry"
}

  1. Fill in SKILL.md with your learnings, especially the Failed Attempts table.

  2. Validate before committing:

python scripts/validate_plugins.py

Failed Attempts (Critical)

Attempt Why it Failed Lesson Learned
Generic descriptions Skills weren't discoverable by /advise Always include specific trigger conditions
Omitting failed attempts Teammates repeated same mistakes Document failures even more than successes
Vague parameters Results weren't reproducible Include exact, copy-pasteable configs

Final Parameters

The minimum required plugin.json structure:

{
  "name": "skill-name",
  "description": "Trigger conditions...",
  "skills": "./skills"
}

Key Insights

  • The Failed Attempts table is referenced more than any other section
  • Specific trigger conditions in descriptions make /advise more useful
  • Include environment details for reproducibility
  • Keep skills focused - one experiment per skill

References