Agent Skill
2/7/2026

claude-skills

Guide for creating Agent Skills with progressive disclosure and best practices. Use when creating new skills, understanding skill structure, or implementing progressive disclosure.

V
vinnie357
5GitHub Stars
1Views
npx skills add vinnie357/claude-skills

SKILL.md

Nameclaude-skills
DescriptionGuide for creating Agent Skills with progressive disclosure and best practices. Use when creating new skills, understanding skill structure, or implementing progressive disclosure.

Claude Skills Marketplace

A curated collection of modular, self-contained skills that extend Claude's capabilities with specialized knowledge across multiple programming languages, development tools, workflow orchestration, and software development best practices.

Quick Start

Installation

Add the marketplace and install plugins:

# Add the vinnie357 marketplace
/plugin marketplace add vinnie357/claude-skills

# Install all skills (meta-plugin)
/plugin install all-skills@vinnie357

# Or install individual plugins selectively:
/plugin install core@vinnie357        # Git, documentation, code review, accessibility
/plugin install elixir@vinnie357      # Elixir, Phoenix, OTP, testing
/plugin install rust@vinnie357        # Rust language features
/plugin install wasm@vinnie357        # WebAssembly and Wasmtime
/plugin install dagu@vinnie357        # Workflow orchestration
/plugin install github@vinnie357      # GitHub Actions, workflows, act
/plugin install slidev@vinnie357      # Slidev presentations
/plugin install ui@vinnie357          # daisyUI, Tailwind CSS theming
/plugin install claude-code@vinnie357 # Plugin marketplace management tools

Verify installation:

/plugin list

Available Plugins

all-skills - Complete Bundle

Meta-plugin that installs all available skills from all other plugins. Install this for the full experience.

Keywords: all, complete, bundle

core - Essential Development Skills

Fundamental development tools and best practices.

Skills:

  • git - Git operations, conventional commits, branching, conflict resolution
  • mise - Development environment and tool version management
  • nushell - Modern shell with structured data pipelines
  • documentation - Technical writing, README files, API documentation
  • code-review - Code review best practices for security and maintainability
  • accessibility - Web accessibility standards (WCAG, ARIA)
  • material-design - Material Design 3 design system
  • twelve-factor - Cloud-native application design principles
  • anti-fabrication - Ensure factual accuracy through tool validation
  • security - Secret detection and credential scanning with gitleaks
  • beads - Distributed git-backed graph issue tracker
  • container - Apple Container CLI for Linux containers on macOS

Keywords: git, documentation, code-review, tools, beads, container

elixir - Elixir Development

Comprehensive Elixir and Phoenix development skills.

Skills:

  • anti-patterns - Identify and refactor Elixir code smells and anti-patterns
  • phoenix - Phoenix framework with LiveView, contexts, and channels
  • otp - OTP behaviors (GenServer, Supervisor, Task, Agent)
  • testing - ExUnit testing, property-based testing, mocks
  • config - Runtime vs compile-time configuration best practices

Keywords: elixir, phoenix, otp, beam

rust - Rust Programming

Rust language features and best practices.

Skills:

  • rust - Ownership, borrowing, lifetimes, error handling, async programming

Keywords: rust, systems-programming, memory-safety

wasm - WebAssembly Development

WebAssembly runtime, compilation, and embedding skills.

Skills:

  • wasmtime - Wasmtime runtime, Component Model, WIT, WASI, guest compilation (Rust, Zig), host embedding (Rust, Elixir)

Keywords: wasm, webassembly, wasmtime, wasi, component-model

dagu - Workflow Orchestration

Dagu workflow orchestration and automation.

Skills:

  • workflows - YAML workflow authoring, scheduling, dependencies
  • webui - Dagu web interface for workflow management
  • rest-api - Programmatic workflow control via REST API

Keywords: dagu, workflow, orchestration

ui - UI Development

UI framework and component library skills.

Skills:

  • daisyui - daisyUI component library with Tailwind CSS theming

Keywords: ui, daisyui, tailwind

github - GitHub Development Tools

GitHub Actions, workflows, and local testing.

Skills:

  • actions - Creating and configuring GitHub Actions
  • workflows - Writing and optimizing GitHub Actions workflows
  • act - Testing GitHub Actions locally using act

Keywords: github, actions, workflows, ci-cd, act, testing

slidev - Presentation Framework

Slidev markdown-based presentation development.

Skills:

  • slidev - Overview, project setup, and routing to sub-skills
  • slidev-syntax - Slide separators, frontmatter, layouts, MDC, notes, transitions
  • slidev-code - Shiki highlighting, Monaco editor, Magic Move, TwoSlash, code groups
  • slidev-export - PDF, PPTX, PNG export, SPA build, CLI flags
  • slidev-troubleshooting - Export failures, font issues, configuration debugging

Keywords: slidev, presentation, slides, markdown, vite

claude-code - Plugin Development Tools

Claude Code plugin marketplace management and validation.

Skills:

  • plugin-marketplace - Marketplace.json schema, validation, management
  • plugin - Plugin.json schema, validation, creation
  • commands - Creating custom slash commands
  • agents - Creating specialized agents
  • skills - Creating Agent Skills (complete guide)
  • hooks - Event-driven hooks and automations

Includes Nushell Scripts:

  • Marketplace validation and initialization
  • Plugin validation and formatting
  • Dependency graph analysis
  • Schema compliance checking

Keywords: claude-code, marketplace, validation

Usage

Skills are automatically activated by Claude based on task context once plugins are installed.

Examples

Elixir Development:

"Review this GenServer implementation for anti-patterns"
"Help me write tests for this Phoenix LiveView"
"What's the best way to structure this context?"

Git Operations:

"Create a conventional commit message for these changes"
"How do I rebase my feature branch?"
"Help me resolve this merge conflict"

Rust Development:

"Explain this lifetime error"
"How do I handle errors with Result?"
"Review this code for Rust best practices"

WebAssembly Development:

"Help me compile this Rust library to wasm"
"Embed a wasm plugin system using Wasmtime in Rust"
"Set up Wasmex to run wasm modules in Elixir"

Workflow Orchestration:

"Create a Dagu workflow for this ETL pipeline"
"How do I trigger this workflow via the API?"
"Add retry logic to this workflow step"

UI Development:

"Create a card component with daisyUI"
"Make this form accessible for screen readers"
"Apply Material Design 3 principles to this interface"

Plugin Architecture

The marketplace uses a categorized architecture with plugins organized under plugins/:

claude-skills/
├── .claude-plugin/
│   └── marketplace.json          # Marketplace definition
└── plugins/
    ├── core/                     # Essential development skills
    ├── languages/
    │   ├── elixir/               # Elixir development
    │   └── rust/                 # Rust programming
    ├── tools/
    │   ├── claude-code/          # Plugin development tools
    │   ├── dagu/                 # Workflow orchestration
    │   ├── github/               # GitHub Actions and workflows
    │   └── slidev/               # Presentation framework
    ├── ui/                       # UI frameworks
    └── wasm/                     # WebAssembly development

Each plugin contains:

plugin-name/
├── .claude-plugin/
│   └── plugin.json        # Plugin manifest
└── skills/                # Skill definitions
    ├── skill-1/
    │   ├── SKILL.md
    │   ├── references/    # Detailed docs (optional)
    │   └── scripts/       # Executable scripts (optional)
    ├── skill-2/
    └── sources.md         # Source attribution

Selective Installation

Install only the plugins you need:

# Frontend developer
/plugin install core@vinnie357
/plugin install ui@vinnie357

# Elixir developer
/plugin install core@vinnie357
/plugin install elixir@vinnie357

# Rust developer
/plugin install core@vinnie357
/plugin install rust@vinnie357

# WebAssembly developer
/plugin install core@vinnie357
/plugin install wasm@vinnie357
/plugin install rust@vinnie357

# DevOps/Platform engineer
/plugin install core@vinnie357
/plugin install dagu@vinnie357

# Plugin developer
/plugin install claude-code@vinnie357

What Are Agent Skills?

Agent Skills are organized directories containing instructions, scripts, and resources that Claude can dynamically discover and load. They enable a single general-purpose agent to gain domain-specific expertise without requiring separate custom agents for each use case.

Key Benefits

  • Modularity: Self-contained packages that can be mixed and matched
  • Reusability: Share and distribute expertise across projects and teams
  • Progressive Disclosure: Load context only when needed, keeping interactions efficient
  • Specialization: Deep domain knowledge without sacrificing generality

How Skills Work

Skills operate on progressive disclosure across multiple levels:

  1. Discovery: Agent prompts include only skill names and descriptions
  2. Activation: Claude loads the full SKILL.md when the skill is relevant
  3. Deep Context: Additional files load only when needed for specific scenarios

This tiered approach maintains efficient context windows while supporting complex skill requirements.

Creating Custom Skills

You can contribute skills to existing plugins or create new ones:

Adding to Existing Plugins

  1. Create a new skill directory:

    mkdir -p plugins/languages/elixir/skills/my-skill
    
  2. Create SKILL.md with YAML frontmatter:

    ---
    name: my-skill
    description: Brief description of what this skill helps with
    license: MIT
    ---
    
    # My Skill
    
    Instructions and guidance...
    
  3. Update the plugin's plugin.json:

    {
      "skills": [
        "./skills/my-skill"
      ]
    }
    
  4. Document sources in the plugin's skills/sources.md

See the Agent Skills Specification for complete guidelines.

Plugin Development

The claude-code plugin provides comprehensive tools for plugin and marketplace development:

  • Complete schema documentation for marketplace.json and plugin.json
  • Nushell validation scripts for automated compliance checking
  • Skills for creating commands, agents, skills, and hooks
  • Template generation and formatting tools

Install it to build your own Claude Code plugins:

/plugin install claude-code@vinnie357

Testing

The repository includes automated validation tests for the marketplace and all 11 plugins (including the all-skills meta-plugin).

Requirements

  • Nushell - Modern shell for running validation scripts
  • mise - Development tool manager (optional, for running tasks)

Quick Start

# Install mise (if not already installed)
curl https://mise.run | sh

# Run all tests (validates marketplace + all 11 plugins)
mise test

# Test specific plugin
mise test:plugin elixir
mise test:plugin all-skills  # Test the meta-plugin

# Test marketplace only
mise test:marketplace

# Test all plugins
mise test:plugins

What Gets Tested

  • Marketplace validation: Required fields, plugin entries, JSON structure
  • Plugin validation (all 11 plugins including all-skills):
    • Name matches directory (or root for all-skills)
    • No invalid marketplace-only fields
    • Kebab-case naming
    • Skill paths exist

Maintaining the Meta-Plugin

The all-skills meta-plugin aggregates all skills from all other plugins. When you add or remove skills:

# Update all-skills plugin.json with all current skills
mise update-all-skills

# Preview changes first
mise update-all-skills --dry-run

# See detailed output
mise update-all-skills --verbose

This automatically collects all skills from all plugins and updates .claude-plugin/plugin.json.

Without mise

You can run the Nushell scripts directly:

# All tests
nu test/validate-all.nu

# Specific plugin
nu test/validate-plugin.nu elixir

# Update all-skills
nu .claude-plugin/scripts/update-all-skills.nu

See test/README.md for complete testing documentation.

GitHub Actions CI/CD

The repository includes automated CI/CD via GitHub Actions that runs on:

  • Pull requests (all branches)
  • Pushes to main branch

What gets tested:

  • Validates marketplace.json schema
  • Validates all plugin.json files (11 plugins)
  • Checks skill paths exist
  • Verifies naming conventions

The workflow uses a custom action (.github/actions/validate-marketplace) with caching for fast execution.

Local GitHub Actions Testing

Test the GitHub Actions workflow locally before pushing:

# Start colima (provides Docker for act on macOS)
mise colima:start

# Test pull request workflow
mise test:action:pr

# Test push to main workflow
mise test:action:push

# When done, stop colima
mise colima:stop

Requirements (macOS only):

  • Lima and Colima (installed automatically via mise colima:start)
  • Docker-compatible runtime for running act

Note: Ubuntu/Linux uses native Docker and doesn't need colima.

Sources and Attribution

Each plugin maintains its own skills/sources.md file documenting the official documentation, guides, and resources used to create the skills.

Primary sources include:

Contributing

Contributions are welcome! To contribute:

  1. Fork the repository
  2. Create a feature branch
  3. Add or improve skills following the Agent Skills Specification
  4. Document sources in the appropriate plugin's skills/sources.md
  5. Submit a pull request

Contribution Guidelines

  • Follow progressive disclosure pattern (lean SKILL.md, detailed references/)
  • Use imperative/infinitive form in skill instructions
  • Test skills with real-world scenarios
  • Update plugin.json when adding new skills
  • Include proper YAML frontmatter with name, description, and license

License

MIT License - see LICENSE file for details.

Additional Resources

Support

Version History

1.0.0 (Current)

  • Tiered marketplace architecture with selective plugin installation
  • 11 plugins: all-skills (meta), claude-code, core, dagu, elixir, github, rust, slidev, ui, wasm, claudio (external)
  • 37 skills covering multiple programming languages and development tools
  • Comprehensive plugin development tools with Nushell validation scripts
Skills Info
Original Name:claude-skillsAuthor:vinnie357