skills CLAUDE.md

edloidas/skills

A collection of Claude Code and other agents skills following the Agent Skills specification.

Never commit or push changes unless explicitly asked. Never commit directly to the main branch unless explicitly asked.

No AI footers: Do not add "Drafted with AI assistance", Claude Code session links, <sub> attribution lines, a trailing --- rule, or anything similar to commit messages, issue bodies, or PR bodies — including PRs created from the web. No Co-Authored-By trailer crediting an assistant either, and an existing one in git history is not licence to repeat it. Add attribution only when this file, the user's own instructions, or the user's prompt asks for it.

Canonical Repo Instructions

CLAUDE.md is the canonical repo instructions file. The repo root also contains an AGENTS.md symlink pointing to this file so Codex and other agents read the same instructions.

Edit CLAUDE.md directly. Do not replace the AGENTS.md symlink with a copied file.

Repository Structure

Skills are organized into plugin groups. Each group has a .claude-plugin/plugin.json for auto-discovery and contains related skills:

<group>/
├── .claude-plugin/
│   └── plugin.json               # Plugin metadata
└── skills/
    └── <skill-name>/             # Canonical skill location — a REAL directory
        ├── SKILL.md              # Required — frontmatter + instructions
        ├── scripts/              # Optional — executable code
        ├── references/           # Optional — docs loaded on demand
        └── assets/               # Optional — templates, images, data

<group>/skills/<skill-name>/ is the one canonical location for a skill, and it must be a real directory — never a symlink. Two independent constraints force this:

1. Claude Code's plugin loader looks inside the plugin's skills/ directory, not the plugin root. A skill outside <group>/skills/ is invisible to the plugin even though SKILL.md, plugin.json, and the marketplace entry all exist.
2. Agent skill CLIs (notably npx skills) discover skills with readdir(withFileTypes) + entry.isDirectory(), which is false for a symlink. A symlinked skill directory is invisible to them. They also hard-skip directories named node_modules, .git, dist, build, and __pycache__ — which is why the build/ group is only reachable through the <group>/skills/ path that the marketplace manifest points at.