From 15567c08c6f9789c382fa8e1602b2293ae5ff592 Mon Sep 17 00:00:00 2001
From: Yordis Prieto <yordis.prieto@gmail.com>
Date: Thu, 30 Apr 2026 08:05:14 -0400
Subject: [PATCH 1/2] feat(agents): add scaffold-plugin skill

Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
---
 .agents/skills/scaffold-plugin/SKILL.md | 132 ++++++++++++++++++++++++
 1 file changed, 132 insertions(+)
 create mode 100644 .agents/skills/scaffold-plugin/SKILL.md

diff --git a/.agents/skills/scaffold-plugin/SKILL.md b/.agents/skills/scaffold-plugin/SKILL.md
new file mode 100644
index 0000000..95f5a45
--- /dev/null
+++ b/.agents/skills/scaffold-plugin/SKILL.md
@@ -0,0 +1,132 @@
+---
+name: scaffold-plugin
+description: >-
+  Scaffold a new plugin in this repository with all required wiring.
+  Use when creating a new plugin from scratch. Do not use for adding skills to
+  an existing plugin or for modifying plugin metadata.
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+---
+
+# Scaffold a New Plugin
+
+Create a new plugin with all the required files and registry wiring so it is ready for skills to be added.
+
+## When to Use
+
+- Creating a brand new plugin in this repository
+- User asks to "scaffold", "create", or "set up" a new plugin
+
+## When NOT to Use
+
+- Adding skills to an existing plugin (just create the skill directory and SKILL.md)
+- Modifying an existing plugin's metadata (edit plugin.json directly)
+- Renaming or moving a plugin
+
+## Workflow
+
+### 1. Gather Plugin Information
+
+Ask the user for the plugin name if not already provided. The name must:
+- Use kebab-case
+- Be prefixed with `trogonstack-`
+- Be concise and descriptive
+
+Ask for a one-line description if not already provided.
+
+### 2. Create Plugin Directory Structure
+
+```
+plugins/{plugin-name}/
+├── .claude-plugin/
+│   └── plugin.json
+├── skills/           (empty, ready for skills)
+└── README.md
+```
+
+Do NOT create a CHANGELOG.md — release-please manages that automatically.
+
+### 3. Create plugin.json
+
+```json
+{
+  "name": "{plugin-name}",
+  "description": "{description}",
+  "version": "0.0.1",
+  "author": {
+    "name": "TrogonStack",
+    "url": "https://github.com/TrogonStack"
+  }
+}
+```
+
+### 4. Create README.md
+
+```markdown
+# {plugin-name}
+
+{description}
+
+```bash
+claude plugin install {plugin-name}@trogonstack
+```
+```
+
+### 5. Register in Marketplace
+
+Add an entry to `.claude-plugin/marketplace.json` in the `plugins` array:
+
+```json
+{
+  "name": "{plugin-name}",
+  "description": "{description}",
+  "source": "./plugins/{plugin-name}",
+  "category": "development"
+}
+```
+
+### 6. Register in Release Please Config
+
+Add the package to `.github/release-please-config.json` in the `packages` object:
+
+```json
+"plugins/{plugin-name}": {
+  "component": "{plugin-name}"
+}
+```
+
+### 7. Register in Release Please Manifest
+
+Add the initial version to `.github/release-please-manifest.json`:
+
+```json
+"plugins/{plugin-name}": "0.0.1"
+```
+
+It must be `0.0.1`.
+
+### 8. Commit
+
+Use conventional commit format:
+
+```
+feat({plugin-name}): scaffold plugin for {short purpose}
+```
+
+## Quality Checklist
+
+- [ ] Plugin directory exists at `plugins/{plugin-name}/`
+- [ ] `plugins/{plugin-name}/.claude-plugin/plugin.json` exists with correct name, description, version `0.0.1`, and author
+- [ ] `plugins/{plugin-name}/README.md` exists with install command
+- [ ] `plugins/{plugin-name}/skills/` directory exists (empty)
+- [ ] No CHANGELOG.md was created
+- [ ] `.claude-plugin/marketplace.json` has the new plugin entry
+- [ ] `.github/release-please-config.json` has the new package
+- [ ] `.github/release-please-manifest.json` has the new version entry at `0.0.1`
+- [ ] Description is consistent across plugin.json, marketplace.json, and README.md

From a232387a5af60669762eaad18c89bd8ebc6e95cb Mon Sep 17 00:00:00 2001
From: Yordis Prieto <yordis.prieto@gmail.com>
Date: Thu, 30 Apr 2026 08:22:42 -0400
Subject: [PATCH 2/2] fix(agents): use quadruple backticks for nested code
 fence in scaffold-plugin

Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
---
 .agents/skills/scaffold-plugin/SKILL.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.agents/skills/scaffold-plugin/SKILL.md b/.agents/skills/scaffold-plugin/SKILL.md
index 95f5a45..40bdd5f 100644
--- a/.agents/skills/scaffold-plugin/SKILL.md
+++ b/.agents/skills/scaffold-plugin/SKILL.md
@@ -68,7 +68,7 @@ Do NOT create a CHANGELOG.md — release-please manages that automatically.
 
 ### 4. Create README.md
 
-```markdown
+````markdown
 # {plugin-name}
 
 {description}
@@ -76,7 +76,7 @@ Do NOT create a CHANGELOG.md — release-please manages that automatically.
 ```bash
 claude plugin install {plugin-name}@trogonstack
 ```
-```
+````
 
 ### 5. Register in Marketplace