Marketplace Analysis

Analyze Claude Code plugins to achieve Anthropic-level quality standards.

Core Philosophy

Anthropic Quality Bar: Same or more functionality with leaner, more efficient implementation.

Principles:

• Systems thinking over point fixes
• Elegant simplicity over feature accumulation
• Proven improvements over assumptions
• Deletion over addition

Analysis Process

1. Quick Scan

• Count plugins and components
• Note obvious issues (large files, naming inconsistencies)
• Flag files >500 lines

2. Deep Analysis (per plugin)

1. Read SKILL.md files - check trigger phrases, writing style
2. Read agent descriptions - check triggering examples
3. Read commands - check argument handling
4. Check hooks - validate event usage
5. Map interactions - how components work together

3. Cross-Plugin Analysis

• Find redundancy across plugins
• Check consistency (naming, patterns, styles)
• Identify gaps and conflicts

4. Reference Validation

For each skill, verify bundled references exist:

1. Extract paths from SKILL.md:

   • references/*.md mentions
   • scripts/*.sh or scripts/*.py mentions
   • Markdown links: [text](relative/path)

2. Validate each path:

   • Resolve relative to skill directory
   • Check file exists with Glob
   • Flag missing as "broken reference"

3. Report:

   • Missing references = Priority 1 errors
   • Orphaned files (exist but not referenced) = Priority 3 notes

Anti-Overengineering Checks

Before proposing ANY change:

1. Is this simpler than the original?
2. Does this solve a real problem?
3. Would a new user understand this?
4. Can I remove instead of add?

Red flags:

• Adding abstraction for one use case
• "Might need this later" reasoning
• Recommending deletion based on filename alone

Output Format

## Priority 1: High Impact, Low Effort
- [ ] [Change] - [Why] - [Expected impact] - [How to validate]

## Priority 2: Medium Impact
...

## Priority 3: Consider Later
...

Each recommendation includes validation approach.

References

For detailed guidance:

• references/skill-design-standards.md - Official Anthropic skill-creator guide (authoritative source for skill structure, frontmatter, progressive disclosure)
• references/quality-standards.md - Quality criteria checklist, anti-patterns (includes summary of official standards)
• references/measuring-improvements.md - Metrics, user testing, validation templates
• references/output-patterns.md - Template and examples patterns for consistent output
• references/workflows.md - Sequential and conditional workflow patterns

Use scripts/analyze-metrics.sh for consistent metric collection.

Consulting Documentation

Verify best practices via claude-code-guide subagent before claiming something is "wrong."

Applying Changes

When implementing improvements:

1. Before any changes: Create TodoWrite items for each improvement
2. Apply changes: Use Edit tool, one logical change at a time
3. MANDATORY verification: Use core:verification skill before claiming complete
4. Evidence required: Run validation commands, report actual output

Never claim "improved" or "fixed" without verification evidence.