skills: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This repository is a Claude Code plugin marketplace that catalogs multiple plugins. Each plugin bundles one or more Agent Skills.

Install marketplace: /plugin marketplace add nibzard/skills

Architecture

Marketplace Structure

skills/
├── .claude-plugin/
│   └── marketplace.json      # Marketplace catalog
├── skills/                   # Plugin directories
│   ├── marimo/               # .claude-plugin/plugin.json + skills/
│   ├── claude-thread-publisher/
│   ├── marp-slide-quality/
│   ├── pentest-toolkit/
│   ├── release-runbook/
│   ├── skill-creator/
│   ├── yt-transcript/
│   └── brand-illustrator/
└── docs/                     # Documentation

Agent Skills Pattern

Skills are model-invoked, and can also be invoked directly via the plugin namespace. Claude discovers them via:

1. Personal: ~/.claude/skills/
2. Project: .claude/skills/
3. Plugin: Bundled with installed plugins (namespaced as /plugin-name:skill-name)

Skill Discovery: Claude matches user requests against Skill description frontmatter. Be specific about when to use the skill.

Progressive Disclosure: SKILL.md is always loaded; supporting files (reference.md, examples.md, scripts) load only when referenced.

Adding New Plugins / Skills

1. Create Plugin Directory

mkdir skills/your-plugin-name

2. Create Plugin Manifest and Skill

mkdir -p skills/your-plugin-name/.claude-plugin
cat > skills/your-plugin-name/.claude-plugin/plugin.json <<'EOF'
{
  "name": "your-plugin-name",
  "description": "Short description for the plugin manager",
  "version": "1.0.0"
}
EOF

mkdir -p skills/your-plugin-name/skills/your-skill-name

---
name: your-skill-name
description: Clear description of what this skill does and when to use it. Include specific triggers and keywords.
allowed-tools: Read, Write, Edit  # Optional: restrict tool access
---

# Your Skill Title

## Instructions
[Step-by-step guidance for Claude]

## Examples
[Concrete usage scenarios]

## Requirements
[Dependencies and prerequisites]