create-plugin

A guide for creating new plugins, skills, hooks, and slash commands in this repository.

In plain words
What is it for?
It helps scaffold a new plugin or add a skill, event-triggered hook, command, or slash command.
Why use it?
It provides the repository's expected structure and helps choose the right add-on type for a requested workflow.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/cboone/agent-harness-plugins/create-plugin
Any agent
npx skills add cboone/agent-harness-plugins --skill create-plugin
Clone the repo
git clone --depth 1 https://github.com/cboone/agent-harness-plugins

Made for: Claude Code, Codex.

Per session 81 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,579 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00081 $0.02579
Opus 5 $0.00041 $0.01290
Sonnet 5 $0.00016 $0.00516
Haiku 4.5 $0.00008 $0.00258

Measured yesterday against content hash fb2764d3d7ad, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

create-plugin scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/create-plugin/skills/create-plugin/SKILL.md · 212 lines

How it starts

The opening of the file, as written. The whole thing — 212 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Create Plugin

Create a new plugin for this repository following established conventions.

Workflow

1. Determine Plugin Type

Infer the plugin type from the user's request:

  • Skills plugin: Provides instructions and workflows that Claude Code follows (e.g., style guides, multi-step procedures). Most plugins are this type.
  • Command plugin: Provides slash commands that users invoke explicitly (e.g., /example-command). Commands are structured Markdown files with frontmatter, a workflow, and optional reference templates.
  • Hooks plugin: Provides event-driven shell commands that run automatically in response to Claude Code lifecycle events (e.g., notifications on task completion).
  • Combinations: A plugin can provide any combination of skills, commands, and hooks.

Inference heuristic: "create a command", "add a slash command", "add a /something command" implies a command plugin. "create a skill", "add a style guide", "add a workflow" implies a skills plugin. "create a hook", "add a notification" implies a hooks plugin.

If the request doesn't imply a type (e.g., just "create a plugin"), ask. If ambiguous, default to a skills plugin.

2. Choose a Name

The plugin name must be:

  • Kebab-case (e.g., write-go-code, suggest-next-issue)
  • Verb-noun preferred (e.g., create-worktree-from-issue, resolve-copilot-pr-feedback)
  • Descriptive of what the plugin does
  • Unique within the plugins/ directory

If the user provided a name, use it. Otherwise, generate a descriptive name from the plugin's purpose and proceed.

3. Create Directory Structure

No manual mkdir is needed — the Write tool creates parent directories automatically when writing files. The directories below are created implicitly when their first file is written in the subsequent steps.

Skills Plugin
plugins/PLUGIN-NAME/.claude-plugin/
plugins/PLUGIN-NAME/skills/PLUGIN-NAME/

Add a references/ subdirectory if the skill needs supplementary documentation:

Read the full file on GitHub · 212 lines

Files

What ships with it

7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 212 lines · 81 tokens per session scan A fb2764d3d7ad

Subscribe to this mod's changes

create-plugin is a skill published in the GitHub repository cboone/agent-harness-plugins (2 stars, last pushed 1mo ago), licensed MIT. It adds 81 tokens to every session and 2,579 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories