feat(agents): add scaffold-plugin skill

[yordis]

• Codify the plugin scaffolding process into a reusable agent skill so new plugins can be created consistently without remembering the manual wiring steps across multiple config files

[cursor]

PR Summary

Low Risk
Documentation-only addition of an agent skill; no runtime code or configuration is changed by this PR itself.

Overview
Adds a new agent skill, scaffold-plugin, that codifies the steps and required files to scaffold a new plugin (directory layout, plugin.json, and README.md).

The skill also documents the required registry wiring for new plugins, including adding entries to .claude-plugin/marketplace.json and release-please config/manifest, plus a checklist and commit message convention to keep scaffolding consistent.

^{Reviewed by Cursor Bugbot for commit a232387. Bugbot is set up for automated code reviews on this repo. Configure here.}

[coderabbitai]

Warning

Rate limit exceeded

@yordis has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 42 minutes and 37 seconds before requesting another review.

To keep reviews running without waiting, you can enable usage-based add-on for your organization. This allows additional reviews beyond the hourly cap. Account admins can enable it under billing.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 37d8a977-b83f-476f-8658-404e4cf901b0

📥 Commits

Reviewing files that changed from the base of the PR and between edca532 and a232387.

📒 Files selected for processing (1)

• .agents/skills/scaffold-plugin/SKILL.md

Walkthrough

A new skill documentation file is introduced that provides comprehensive instructions for scaffolding a brand-new plugin. The guide specifies input requirements, required directory structure, configuration file contents, and integration steps into marketplace and release configuration files.

Changes

Cohort / File(s)	Summary
Plugin Scaffolding Documentation .agents/skills/scaffold-plugin/SKILL.md	New skill guide documenting the complete process for creating a plugin from scratch, including directory structure, required configuration files with hardcoded version 0.0.1, marketplace and release configuration integration, and a quality verification checklist.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A skill to build from empty air,
Scaffolding plugins with utmost care,
Directories sprouted, configs aligned,
One-twenty-five lines of structure refined! 🏗️

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'feat(agents): add scaffold-plugin skill' accurately reflects the main change—introducing a new scaffold-plugin skill documentation.
Description check	✅ Passed	The description clearly explains the purpose of the change: codifying the plugin scaffolding process into a reusable agent skill for consistent, automated plugin creation.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch add-skill

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Review rate limit: 0/1 reviews remaining, refill in 42 minutes and 37 seconds.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🧹 Nitpick comments (3)

.agents/skills/scaffold-plugin/SKILL.md (3)

64-72: 💤 Low value

Consider adding a language specifier to the fenced code block.

Specifying markdown as the language improves rendering and clarity for this template block.

📝 Proposed fix

-```
+```markdown
 # {plugin-name}

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In @.agents/skills/scaffold-plugin/SKILL.md around lines 64 - 72, Update the
Markdown fenced code block that currently shows the template header and example
to include an explicit language specifier; change the opening triple-backticks
for the block containing "# {plugin-name}" to "```markdown" so the header and
template render as Markdown (also ensure the subsequent example shell block
remains "```bash" for the install command).

---

111-113: 💤 Low value

Consider adding a language specifier to the fenced code block.

Adding text as the language specifier improves markdown consistency.

📝 Proposed fix

-```
+```text
 feat({plugin-name}): scaffold plugin for {short purpose}

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In @.agents/skills/scaffold-plugin/SKILL.md around lines 111 - 113, Update the
fenced code block containing "feat({plugin-name}): scaffold plugin for {short
purpose}" in SKILL.md to include a language specifier (use "text") after the
opening triple backticks so the block becomes ```text ... ```; this is a
formatting-only change to improve markdown consistency and does not modify the
content string itself.

---

38-44: 💤 Low value

Consider adding a language specifier to the fenced code block.

Adding a language specifier improves markdown rendering consistency.

📝 Proposed fix

-```
+```text
 plugins/{plugin-name}/

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In @.agents/skills/scaffold-plugin/SKILL.md around lines 38 - 44, The fenced
code block showing the directory tree beginning with "plugins/{plugin-name}/" in
SKILL.md lacks a language specifier; update that opening fence (the triple
backticks before the tree) to include a language like "text" (e.g., ```text) so
the directory listing renders consistently in Markdown viewers and code
renderers.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.agents/skills/scaffold-plugin/SKILL.md:
- Around line 48-60: The scaffold's plugin.json example sets "version": "0.0.1"
which is inconsistent with existing plugins; update the example in SKILL.md so
the "version" field matches the project's actual initial versioning (e.g.,
change "version": "0.0.1" to the agreed initial version such as "0.0.2" or
"0.1.0"), or add a short clarifying note next to the plugin.json block
explaining the project's initial versioning convention; specifically edit the
plugin.json example's "version" field in the SKILL.md plugin scaffold to reflect
the chosen standard.

---

Nitpick comments:
In @.agents/skills/scaffold-plugin/SKILL.md:
- Around line 64-72: Update the Markdown fenced code block that currently shows
the template header and example to include an explicit language specifier;
change the opening triple-backticks for the block containing "# {plugin-name}"
to "```markdown" so the header and template render as Markdown (also ensure the
subsequent example shell block remains "```bash" for the install command).
- Around line 111-113: Update the fenced code block containing
"feat({plugin-name}): scaffold plugin for {short purpose}" in SKILL.md to
include a language specifier (use "text") after the opening triple backticks so
the block becomes ```text ... ```; this is a formatting-only change to improve
markdown consistency and does not modify the content string itself.
- Around line 38-44: The fenced code block showing the directory tree beginning
with "plugins/{plugin-name}/" in SKILL.md lacks a language specifier; update
that opening fence (the triple backticks before the tree) to include a language
like "text" (e.g., ```text) so the directory listing renders consistently in
Markdown viewers and code renderers.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 07e04f93-f44f-4118-b570-b0d94403df9a

📥 Commits

Reviewing files that changed from the base of the PR and between 1788699 and edca532.

📒 Files selected for processing (1)

• .agents/skills/scaffold-plugin/SKILL.md

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit edca532. Configure here.}