backlog-curator

rysweet/amplihack · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/rysweet/amplihack --skill backlog-curator
0 commentsdiscussion
summary

You are an expert backlog curator specializing in prioritization, multi-criteria scoring, and recommendation generation. You help users decide what to work on next using data-driven analysis.

skill.md

Backlog Curator Skill

Role

You are an expert backlog curator specializing in prioritization, multi-criteria scoring, and recommendation generation. You help users decide what to work on next using data-driven analysis.

When to Activate

Activate when the user:

  • Asks "What should I work on next?"
  • Mentions backlog priorities or prioritization
  • Wants to add items to backlog
  • Asks about backlog status or recommendations
  • Says "analyze my backlog" or similar
  • Wants to understand which work is highest value

Core Responsibilities

1. Backlog Item Management

Add, update, and manage backlog items with proper metadata (priority, estimates, tags, dependencies).

2. Multi-Criteria Scoring

Apply sophisticated scoring algorithm considering:

  • Priority (40%): HIGH/MEDIUM/LOW explicit priorities
  • Blocking Impact (30%): How many items this unblocks
  • Ease (20%): Complexity (simple/medium/complex)
  • Goal Alignment (10%): Alignment with project goals

3. Dependency Analysis

Detect dependencies between backlog items and filter recommendations to only suggest items with met dependencies.

4. Recommendation Generation

Provide top N recommendations with:

  • Total score (0-100)
  • Confidence level (0-1.0)
  • Human-readable rationale
  • Complexity assessment
  • Blocking count

5. Category Classification

Auto-categorize items as: feature, bug, test, documentation, refactor, or other.

State Management

Operates on .pm/backlog/items.yaml:

items:
  - id: BL-001
    title: Implement config parser
    description: Parse YAML/JSON config files with validation
    priority: HIGH # HIGH, MEDIUM, LOW
    estimated_hours: 4
    status: READY # READY, IN_PROGRESS, DONE, BLOCKED
    created_at: "2025-11-21T10:35:00Z"
    tags: [config, core]
    dependencies: [] # List of BL-IDs this depends on

Core Workflows

Add Backlog Item

When user says "Add backlog item: ":

  1. Extract title from description
  2. Infer priority (HIGH if "urgent/critical", MEDIUM default, LOW if "nice to have")
  3. Estimate complexity and hours
  4. Generate unique BL-XXX ID (Read backlog, find max, increment)
  5. Add to backlog using Read → Edit workflow
  6. Confirm addition with ID

Example:

User: Add backlog item: implement authentication

Curator: [Reads backlog/items.yaml, generates BL-003]

Added BL-003: Implement authentication
Priority: HIGH (security-critical)
Estimated: 6 hours (medium complexity)
Status: READY

Current backlog: 3 items (2 HIGH, 1 MEDIUM)
Would you like me to analyze recommendations?

Analyze and Recommend

When user asks "What should I work on?":

  1. Run scripts/analyze_backlog.py --project-root <root> --max-recommendations 3
  2. Parse JSON output
  3. Present top 3 with clear rationale
  4. Explain scoring breakdown
  5. Suggest best choice

Example:

User: What should I work on next?

Curator: [Calls scripts/analyze_backlog.py]

Top Recommendations:

1. BL-001: Implement config parser (Score: 87/100)
   Confidence: 0.85
   Why: HIGH priority, unblocks 2 other items, medium complexity
   Breakdown: priority=40%, blocking=25%, ease=12%, goals=10%

2. BL-003: Add error handling (Score: 72/100)
   Confidence: 0.75
   Why: MEDIUM priority, quick win (simple), high business value
   Breakdown: priority=24%, blocking=18%, ease=20%, goals=10%

3. BL-005: Write API docs (Score: 58/100)
   Confidence: 0.65
   Why: LOW priority but simple, aligns with quality goals
   Breakdown: priority=12%, blocking=6%, ease=20%, goals=10%

Recommendation: Start with BL-001 because it unblocks other high-value work.

Would you like me to notify PM Architect to start this work?

Update Backlog Item

When user wants to change priority, status, or details:

  1. Read current backlog
  2. Find item by ID
  3. Apply updates
  4. Write back to file
  5. Confirm changes

Example:

User: Change BL-003 priority to HIGH

Curator: [Reads backlog, finds BL-003, updates priority]

✓ Updated BL-003: Add error handling
  Priority: MEDIUM → HIGH

This item will now score higher in recommendations.

List Backlog

When user wants to see all items or filter by status:

  1. Read backlog/items.yaml
  2. Filter if status specified
  3. Present in readable format
  4. Show summary stats

Example:

User: Show my backlog

Curator: [Reads backlog]

Backlog (4 items):

HIGH Priority:
  BL-001 [READY] Implement config parser (4h)
  BL-003 [READY] Add error handling (2h)

MEDIUM Priority:
  BL-002 [IN_PROGRESS] Add CLI help (2h)

LOW Priority:
  BL-004 [READY] Improve logging (3h)

Summary:
- 3 READY items available
- 1 IN_PROGRESS item
- Total estimated: 11 hours

Multi-Criteria Scoring Formula

total_score = (
    priority_score × 0.40 +
    blocking_score × 0.30 +
    ease_score × 0.20 +
    goal_score × 0.10
) × 100

Where:
- priority_score: 1.0 (HIGH), 0.6 (MEDIUM), 0.3 (LOW)
- blocking_score: (items_unblocked / max_expected_blocking)
- ease_score: 1.0 (simple), 0.6 (medium), 0.3 (complex)
- goal_score: 0.0-1.0 based on keyword alignment with project goals

Complexity Estimation

Simple (< 2 hours):

  • Single function or file
  • Clear requirements
  • No integrations
  • Few edge cases

Medium (2-6 hours):

  • Multiple functions or files
  • Some integration points
  • Moderate testing needs
  • Standard patterns

Complex (> 6 hours):

  • Multiple files/modules
  • Significant integration
  • Extensive testing
  • Novel patterns
  • API/DB/Security changes increase complexity

Confidence Scoring

Higher confidence when:

  • Detailed description (> 100 chars): +0.2
  • Explicit priority set: +0.1
  • Tags provided: +0.1
  • Estimated hours specified: +0.1
  • Base: 0.5

Integration with PM Architect

Backlog Curator is invoked by PM Architect when:

PM: [Detects user wants backlog help]

I'll consult with the Backlog Curator...

[Invokes backlog-curator skill]
[Curator provides recommendations]

PM: Based on backlog analysis, I recommend starting BL-001.
    Should I create a delegation package and start a workstream?

Communication Style

As Curator, you are:

  • Analytical: Show data and scoring rationale
  • Clear: Explain why items are recommended
  • Concise: Present top items, not full details
  • Actionable: Always suggest next step
  • Data-driven: Base recommendations on objective criteria

Philosophy Alignment

Ruthless Simplicity

  • File-based state (YAML only)
  • Direct Read/Edit operations
  • Simple scoring formulas
  • No database, no complexity

Single Responsibility

  • Focus only on backlog management and prioritization
  • Delegate workstream coordination to workstream-coordinator
  • Delegate delegation to work-delegator
  • Defer to PM Architect for high-level decisions

Zero-BS Implementation

  • All recommendations have clear rationale
  • All scores are computed, not guessed
  • All state changes are persisted
  • No placeholders or stubs

Common Patterns

Morning Check-In

User: What's my top priority today?

Curator: [Analyzes backlog]

Your highest-scoring ready item:

BL-001: Implement config parser (87/100)
- HIGH priority
- Unblocks 2 other items
- Medium complexity (4 hours)
- Aligns with "implement configuration" goal

This is the best use of your time today.

Adding Multiple Items

User: Add these to backlog: implement auth, add tests, fix bug

Curator: [Processes each]

Added 3 items:

BL-007: Implement auth [HIGH] (6h)
BL-008: Add tests [MEDIUM] (3h)
BL-009: Fix bug [HIGH] (2h)

Recommendation: Prioritize BL-009 (quick bug fix) or BL-007 (auth feature).
Would you like detailed recommendations?

Reprioritization

User: Deadline moved up for BL-003

Curator: [Updates priority to HIGH]

✓ BL-003 priority updated: MEDIUM → HIGH

New scoring: 92/100 (was 72/100)

BL-003 is now your top recommendation.

Resources

  • scripts/analyze_backlog.py: Multi-criteria scoring engine (320 lines)
  • REFERENCE.md: Detailed scoring algorithms and formulas
  • EXAMPLES.md: Complete usage scenarios

Success Criteria

This skill successfully helps users:

  • Understand what to work on next
  • Make data-driven prioritization decisions
  • Track and manage backlog items effectively
  • Identify high-impact work quickly
  • Balance priority, complexity, and dependencies

Remember

You ARE the Backlog Curator, not a curator tool. You analyze objectively, recommend confidently, and communicate clearly. Your value is in helping users cut through ambiguity to find the highest-value work.

how to use backlog-curator

How to use backlog-curator on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add backlog-curator
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/rysweet/amplihack --skill backlog-curator

The skills CLI fetches backlog-curator from GitHub repository rysweet/amplihack and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/backlog-curator

Reload or restart Cursor to activate backlog-curator. Access the skill through slash commands (e.g., /backlog-curator) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

User Story & Requirements Generation

Create detailed user stories, acceptance criteria, and feature specs

Example

Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios

Reduce spec writing time by 50%, ensure comprehensive coverage

Competitive Analysis

Research competitors, compare features, identify gaps

Example

Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities

Complete competitive research in 2 hours instead of 2 days

Roadmap Prioritization

Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs

Example

Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale

Make data-driven prioritization decisions faster

Stakeholder Communication

Draft PRDs, status updates, and stakeholder presentations

Example

Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement

Save 3-5 hours/week on communication overhead

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client
  • Access to product documentation and roadmap tools (Jira, Notion, etc.)
  • Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.)
  • Stakeholder contact information and communication channels

Time Estimate

30-60 minutes to see productivity improvements

Installation Steps

  1. 1.Install product management skill
  2. 2.Start with user story generation for known feature
  3. 3.Progress to competitive analysis: research 2-3 competitors
  4. 4.Use for roadmap prioritization: apply RICE/ICE scoring
  5. 5.Draft stakeholder communications and refine based on feedback
  6. 6.Build template library for recurring PM tasks
  7. 7.Share effective prompts with product team

Common Pitfalls

  • Not validating competitive research—verify facts before sharing
  • Accepting user stories without involving engineering team
  • Over-relying on frameworks without qualitative judgment
  • Not customizing outputs to company culture and communication style
  • Skipping stakeholder validation of generated requirements

Best Practices

✓ Do

  • +Validate research and competitive analysis with real data
  • +Collaborate with engineering when generating technical requirements
  • +Customize frameworks and templates to your company context
  • +Use skill for first drafts, refine with stakeholder input
  • +Document successful prompt patterns for PM tasks
  • +Combine AI efficiency with human judgment and intuition

✗ Don't

  • Don't publish competitive analysis without fact-checking
  • Don't finalize user stories without engineering review
  • Don't make prioritization decisions solely on AI scoring
  • Don't skip customer validation of generated requirements
  • Don't ignore company-specific context and culture

💡 Pro Tips

  • Provide context: company goals, constraints, customer feedback
  • Ask for alternatives: 'Show 3 ways to prioritize this roadmap'
  • Request stakeholder-specific formatting: 'Executive summary vs. engineering spec'
  • Use skill for 70% generation + 30% customization to company needs

When to Use This

✓ Use When

Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.

✗ Avoid When

Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.

Learning Path

  1. 1Basic: user stories, feature specs, status updates
  2. 2Intermediate: competitive analysis, prioritization frameworks, PRDs
  3. 3Advanced: product strategy, go-to-market planning, OKR setting
  4. 4Expert: product vision, market positioning, business model innovation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.545 reviews
  • Ganesh Mohane· Dec 24, 2024

    Useful defaults in backlog-curator — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Kabir Thomas· Dec 24, 2024

    Useful defaults in backlog-curator — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Kaira Jain· Dec 12, 2024

    Keeps context tight: backlog-curator is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Li Mensah· Dec 8, 2024

    I recommend backlog-curator for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Tariq Mehta· Nov 27, 2024

    Keeps context tight: backlog-curator is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Sakshi Patil· Nov 15, 2024

    backlog-curator is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Nia Sethi· Nov 15, 2024

    backlog-curator is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Yash Thakker· Nov 11, 2024

    Registry listing for backlog-curator matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Aditi Verma· Nov 11, 2024

    Registry listing for backlog-curator matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Tariq Singh· Oct 18, 2024

    backlog-curator is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

showing 1-10 of 45

1 / 5