agent-skills: Instructions file for Claude Code

agent-skills — Developer Guide for Claude Code

Repository Purpose

This is a public marketplace of Claude Code plugins by mindbox.cloud. Each plugin extends Claude Code with skills (slash commands), agents, hooks, or MCP servers.

Plugins are designed to be shared with the community. All content must be in English.

---

Repository Structure

agent-skills/
├── .claude-plugin/
│   └── marketplace.json    # marketplace registry — update when adding a plugin
├── plugins/
│   └── <plugin-name>/
│       ├── .claude-plugin/
│       │   └── plugin.json  # plugin manifest
│       ├── skills/
│       │   └── <skill-name>/
│       │       ├── SKILL.md
│       │       └── references/
│       ├── CHANGELOG.md
│       └── README.md
├── CLAUDE.md
├── CONTRIBUTING.md
└── README.md

---

How to Add a New Plugin

Step 1 — Create the directory structure

mkdir -p plugins/<plugin-name>/.claude-plugin
mkdir -p plugins/<plugin-name>/skills/<skill-name>/references

Plugin names: kebab-case, no spaces.

Step 2 — Write plugin.json

{
  "name": "plugin-name",
  "description": "One-line description in English",
  "version": "1.0.0",
  "author": {
    "name": "Author or org name"
  }
}

Required fields: name. Recommended: description, version, author.

Step 3 — Write SKILL.md

---
name: skill-name          # kebab-case, matches folder name
description: >
  What it does — one sentence.
  Use when user says "...", "...", "...".
  Don't use when: user asks for X (use y-skill instead), user asks for Z.
metadata:
  version: 1.0.0          # semver — instruction contract version
---

Skill body: orchestration logic, steps, critical rules, troubleshooting.
Put domain knowledge and checklists in references/, not inline.

Frontmatter requirements:

• name — kebab-case, 1–64 chars, matches folder name
• description — WHAT it does + WHEN to use (trigger phrases) + "Don't use when" (negative triggers)
• metadata.version — semver