Skip to content

Add PitchDocs plugin to Plugins & Extensions#19

Open
nathanschram wants to merge 3 commits intojmanhype:mainfrom
nathanschram:add-pitchdocs
Open

Add PitchDocs plugin to Plugins & Extensions#19
nathanschram wants to merge 3 commits intojmanhype:mainfrom
nathanschram:add-pitchdocs

Conversation

@nathanschram
Copy link
Copy Markdown

Adds PitchDocs to the Plugins & Extensions section — a documentation generation plugin that produces marketing-ready README, CHANGELOG, CONTRIBUTING, AI context files, and 15+ more files with evidence-based feature extraction and quality scoring.\n\n100% Markdown, zero runtime dependencies, MIT licensed. Install via /plugin marketplace add littlebearapps/lba-plugins.

@qodo-code-review
Copy link
Copy Markdown

Review Summary by Qodo

Add PitchDocs documentation generation plugin

✨ Enhancement 📝 Documentation

Grey Divider

Walkthroughs

Description
• Adds PitchDocs plugin to Plugins & Extensions section
• Provides documentation generation with marketing-ready outputs
• Includes feature extraction, quality scoring, GEO optimization
Diagram
flowchart LR
  A["Plugins & Extensions<br/>README.md"] -- "adds PitchDocs<br/>entry" --> B["Documentation<br/>Generation Plugin"]
  B -- "produces" --> C["README, CHANGELOG,<br/>CONTRIBUTING, etc."]
  C -- "with" --> D["Feature Extraction<br/>& Quality Scoring"]
Loading

Grey Divider

File Changes

1. README.md 📝 Documentation +1/-0

Add PitchDocs plugin documentation entry

• Adds PitchDocs plugin entry to Plugins & Extensions section
• Includes link to GitHub repository and installation instructions
• Describes key features: marketing-ready documentation generation, feature extraction, quality
 scoring, GEO optimization
• Specifies installation command via marketplace

README.md


Grey Divider

Qodo Logo

@qodo-code-review
Copy link
Copy Markdown

qodo-code-review Bot commented Mar 6, 2026

Code Review by Qodo

🐞 Bugs (2) 📘 Rule violations (0) 📎 Requirement gaps (0)

Grey Divider


Action required

1. Unclear install syntax 🐞 Bug ✓ Correctness
Description
README’s “How to use” section documents installs as /plugin install /, but the new PitchDocs entry
uses /plugin install pitchdocs@lba-plugins. If the @marketplace form is unsupported (or just
undocumented here), users will be blocked or confused by conflicting instructions.
Code

README.md[21]

+- [PitchDocs](https://github.com/littlebearapps/pitchdocs) - Documentation generation plugin that produces marketing-ready README, CHANGELOG, CONTRIBUTING, AI context files, and 15+ more files with evidence-based feature extraction, quality scoring, and GEO optimisation; install with `/plugin marketplace add littlebearapps/lba-plugins` then `/plugin install pitchdocs@lba-plugins`.
Evidence
The README defines only one install form (/plugin install /). The new entry introduces a different
syntax without any explanation or other examples, making the README self-contradictory.

README.md[5-14]
README.md[21-21]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
The README currently documents plugin installation as `/plugin install &amp;lt;owner&amp;gt;/&amp;lt;repo&amp;gt;`, but the new PitchDocs entry uses `/plugin install pitchdocs@lba-plugins`. This makes the README inconsistent and may mislead users.
### Issue Context
If the `@marketplace` syntax is correct, the README should explicitly document it alongside the existing install form. If it’s not correct, the PitchDocs entry should be changed to match the documented install format.
### Fix Focus Areas
- README.md[5-14]
- README.md[21-21]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools



Advisory comments

2. Overlong description🐞 Bug ⛯ Reliability
Description
The PitchDocs description is much longer and more marketing-like than the repo’s contribution
guidelines suggest, reducing scanability. Consider shortening it to a concise summary and moving
detailed claims to the linked repo.
Code

README.md[21]

+- [PitchDocs](https://github.com/littlebearapps/pitchdocs) - Documentation generation plugin that produces marketing-ready README, CHANGELOG, CONTRIBUTING, AI context files, and 15+ more files with evidence-based feature extraction, quality scoring, and GEO optimisation; install with `/plugin marketplace add littlebearapps/lba-plugins` then `/plugin install pitchdocs@lba-plugins`.
Evidence
The repository contribution guidelines explicitly request short, simple descriptions; the PitchDocs
line is lengthy and feature-dense compared to the intended list style.

contributing.md[7-10]
README.md[21-21]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
The PitchDocs entry is very long relative to the repo’s guideline to keep descriptions short and simple.
### Issue Context
The list is meant to be scannable; detailed feature breakdowns can live in the linked project.
### Fix Focus Areas
- README.md[21-21]
- contributing.md[7-10]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


Grey Divider

ⓘ The new review experience is currently in Beta. Learn more

Grey Divider

Qodo Logo

Comment thread README.md Outdated
- [Claude Code Plugins (jeremylongshore)](https://github.com/jeremylongshore/claude-code-plugins) - Marketplace-style repo bundling instruction-template plugins and MCP plugin packs, with install docs.
- [Multi-Agent Intelligence Marketplace](https://github.com/jmanhype/claude-code-plugins) - 19 production-grade plugins for trading, swarm intelligence, and GitHub automation built from 68+ specialized agents. Includes quantitative trading systems, DSPy research pipelines, distributed consensus protocols, and multi-agent swarm coordination; add with `/plugin marketplace add jmanhype/claude-code-plugins`.
- [Docker Claude Plugins](https://github.com/docker/claude-plugins) - Integrates Docker Desktop's MCP Toolkit as a Claude Code plugin to expose containerized MCP servers through Claude.
- [PitchDocs](https://github.com/littlebearapps/pitchdocs) - Documentation generation plugin that produces marketing-ready README, CHANGELOG, CONTRIBUTING, AI context files, and 15+ more files with evidence-based feature extraction, quality scoring, and GEO optimisation; install with `/plugin marketplace add littlebearapps/lba-plugins` then `/plugin install pitchdocs@lba-plugins`.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Action required

1. Unclear install syntax 🐞 Bug ✓ Correctness

README’s “How to use” section documents installs as /plugin install <owner>/<repo>, but the new
PitchDocs entry uses /plugin install pitchdocs@lba-plugins. If the @marketplace form is
unsupported (or just undocumented here), users will be blocked or confused by conflicting
instructions.
Agent Prompt
### Issue description
The README currently documents plugin installation as `/plugin install <owner>/<repo>`, but the new PitchDocs entry uses `/plugin install pitchdocs@lba-plugins`. This makes the README inconsistent and may mislead users.

### Issue Context
If the `@marketplace` syntax is correct, the README should explicitly document it alongside the existing install form. If it’s not correct, the PitchDocs entry should be changed to match the documented install format.

### Fix Focus Areas
- README.md[5-14]
- README.md[21-21]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools

Address Qodo review:
- Shorten description to match repo's concise entry style
- Use single-step marketplace add (consistent with repo conventions)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@nathanschram
Copy link
Copy Markdown
Author

Addressed both Qodo review items:

  1. Shortened description — trimmed to a concise one-liner matching the style of other entries in the repo.

  2. Simplified install — changed from the two-step marketplace add + plugin install to a single-step /plugin marketplace add littlebearapps/lba-plugins, consistent with the repo's conventions.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant