|
| 1 | +# Claude Code lane |
| 2 | + |
| 3 | + |
| 4 | + |
| 5 | +**Curated Claude Code plugins from the [agentic-utilities](../README.md) marketplace.** |
| 6 | + |
| 7 | +[](https://opensource.org/licenses/MIT) |
| 8 | +[](https://docs.claude.com/en/docs/claude-code) |
| 9 | + |
| 10 | +This is the Claude Code lane of `agentic-utilities` — a multi-harness curated tooling repo with parallel lanes for [Claude Code](https://docs.claude.com/en/docs/claude-code), the [pi coding agent](https://github.com/mariozechner/pi-coding-agent), and OpenAI Codex Agent Skills. Plugins land here when they shine best inside Claude Code; lighter pi extensions live in [`../extensions/`](../extensions/) and harness-agnostic Agent Skills live in [`../skills/`](../skills/). |
| 11 | + |
| 12 | +--- |
| 13 | + |
| 14 | +## Plugins |
| 15 | + |
| 16 | +| Plugin | Description | Install | |
| 17 | +|---|---|---| |
| 18 | +| **[youtube-analyzer](./plugins/youtube-analyzer/)** | Format-aware YouTube video analysis with multi-agent transcript chunking, GitHub repo cross-referencing for tutorials, and package version-drift tracking. | `/plugin install youtube-analyzer@agentic-utilities` | |
| 19 | + |
| 20 | +More plugins land here as they're ported. The [issues tab](https://github.com/AojdevStudio/agentic-utilities/issues) tracks what's queued. |
| 21 | + |
| 22 | +--- |
| 23 | + |
| 24 | +## Quick start |
| 25 | + |
| 26 | +Inside any Claude Code session: |
| 27 | + |
| 28 | +```text |
| 29 | +/plugin marketplace add AojdevStudio/agentic-utilities |
| 30 | +/plugin install <plugin-name>@agentic-utilities |
| 31 | +``` |
| 32 | + |
| 33 | +This works because the marketplace manifest lives at the **repo root** (`.claude-plugin/marketplace.json`), so GitHub-based discovery picks it up without subpath configuration. Plugin source paths in that manifest point into this directory. |
| 34 | + |
| 35 | +--- |
| 36 | + |
| 37 | +## Layout |
| 38 | + |
| 39 | +```text |
| 40 | +claude-code/ |
| 41 | +├── plugins/ |
| 42 | +│ └── <plugin-name>/ |
| 43 | +│ ├── .claude-plugin/ |
| 44 | +│ │ └── plugin.json |
| 45 | +│ ├── commands/ Slash commands (.md) |
| 46 | +│ ├── agents/ Subagents (.md) |
| 47 | +│ ├── skills/ SKILL.md per skill |
| 48 | +│ │ └── <skill-name>/SKILL.md |
| 49 | +│ ├── hooks/ |
| 50 | +│ │ └── hooks.json Event handlers |
| 51 | +│ ├── .mcp.json Optional MCP servers |
| 52 | +│ ├── scripts/ Helper scripts (TS / Python / shell) |
| 53 | +│ └── README.md |
| 54 | +├── assets/ |
| 55 | +│ └── banner.png |
| 56 | +└── README.md This file |
| 57 | +``` |
| 58 | + |
| 59 | +--- |
| 60 | + |
| 61 | +## Add a new plugin |
| 62 | + |
| 63 | +```mermaid |
| 64 | +flowchart LR |
| 65 | + A[Scaffold plugins/<name>/] --> B[Write SKILL.md +<br/>workflows + scripts] |
| 66 | + B --> C[Replace personal paths<br/>with CLAUDE_PLUGIN_ROOT or<br/>AskUserQuestion prompts] |
| 67 | + C --> D[Add entry to<br/>.claude-plugin/marketplace.json] |
| 68 | + D --> E[Local verify:<br/>/plugin marketplace add <path>] |
| 69 | + style A fill:#1a1f3a,stroke:#5eead4,color:#fff |
| 70 | + style E fill:#1a1f3a,stroke:#a78bfa,color:#fff |
| 71 | +``` |
| 72 | + |
| 73 | +1. Scaffold the plugin under `plugins/<plugin-name>/` — `/plugin-dev:create-plugin` works, or copy the layout from an existing plugin. |
| 74 | +2. Write the SKILL.md, workflows, and scripts. **Audit for personal paths** — replace `${PAI_DIR}` and `/Users/...` references with `${CLAUDE_PLUGIN_ROOT}` (for plugin-internal paths) or `AskUserQuestion` prompts (for user-specific data like vault locations). |
| 75 | +3. Add a marketplace entry to `../.claude-plugin/marketplace.json#/plugins[]`: |
| 76 | + |
| 77 | + ```json |
| 78 | + { |
| 79 | + "name": "<plugin-name>", |
| 80 | + "description": "...", |
| 81 | + "version": "0.1.0", |
| 82 | + "author": { "name": "..." }, |
| 83 | + "source": "./claude-code/plugins/<plugin-name>", |
| 84 | + "category": "...", |
| 85 | + "license": "MIT" |
| 86 | + } |
| 87 | + ``` |
| 88 | + |
| 89 | +4. Verify locally: `/plugin marketplace add /Users/you/Projects/agentic-utilities` then `/plugin install <plugin-name>@agentic-utilities`. |
| 90 | + |
| 91 | +--- |
| 92 | + |
| 93 | +## Conventions |
| 94 | + |
| 95 | +- **Plugin names**: kebab-case, globally unique enough to avoid conflicts in users' installs (e.g., `youtube-analyzer`, not `analyzer`). |
| 96 | +- **Internal paths**: every reference to a plugin-bundled file (hooks, MCP servers, helper scripts) uses `${CLAUDE_PLUGIN_ROOT}/...`. |
| 97 | +- **Curation rule**: a plugin lives here only if it shines best in Claude Code. The same logical idea may exist as a pi extension in [`../extensions/`](../extensions/) or a generic Agent Skill in [`../skills/`](../skills/) — they're maintained independently. |
| 98 | +- **Settings file pattern**: user-configurable plugin state goes in `.claude/<plugin-name>.local.md` (YAML frontmatter + markdown body), not hard-coded paths in code. |
| 99 | + |
| 100 | +--- |
| 101 | + |
| 102 | +## License |
| 103 | + |
| 104 | +MIT. |
| 105 | + |
| 106 | +--- |
| 107 | + |
| 108 | +<sub>Part of [agentic-utilities](../README.md). The other lanes — `extensions/` (pi), `skills/` (Codex Agent Skills) — sit alongside this directory at the repo root.</sub> |
0 commit comments