nemoclaw-contributor-plan-issue

Plans NemoClaw GitHub issues into independently valuable capability slices with acceptance evidence.

22.3k|3.1k|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/NVIDIA/NemoClaw --skill nemoclaw-contributor-plan-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nemoclaw-contributor-plan-issue
Source: https://github.com/NVIDIA/NemoClaw/tree/main/.agents/skills/nemoclaw-contributor-plan-issue
Command: npx skills add https://github.com/NVIDIA/NemoClaw --skill nemoclaw-contributor-plan-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Contributors often jump into implementation without confirming scope, ownership, or acceptance criteria, leading to misaligned pull requests and rework. This Skill produces an evidence-based, read-only plan that divides a NemoClaw GitHub issue into independently valuable capability slices before any code is written.

Core Features & Use Cases

  • Evidence-Based Issue Planning: Fetches the issue, current source, tests, workflows, and related PRs to confirm scope authority, current behavior ownership, and delivery constraints before planning.
  • Capability Slicing: Breaks the issue into slices that each deliver one independently valuable outcome, with acceptance examples, dependencies, test plans, and deferred scope recorded per slice.
  • Controlled GitHub Writes: Planning is read-only by default; any authorized write (labels, comments, assignments) is previewed exactly, performed once, and reported with its URL or failure.
  • Use Case: A contributor receives a vague feature request as issue #8378. They run the planning workflow to confirm the accepted scope, identify the current behavior owner, define observable acceptance examples, and select the first slice worth delivering—without touching source code.

Quick Start

Ask the agent to plan NemoClaw issue #8378 and return the structured report with capability slices and the first slice to deliver.

Frequently Asked Questions about nemoclaw-contributor-plan-issue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break down a GitHub issue into smaller deliverable pieces?

Use the planning workflow to divide the issue into capability slices, where each slice delivers one independently valuable user, contributor, or maintainer outcome. Each slice records its outcome, acceptance evidence, dependencies, test plan, and deferred scope rather than splitting by component or layer.

How do I define acceptance criteria for a GitHub issue before coding?

The workflow defines observable acceptance examples covering allowed, denied, ambiguous, failure, and recovery behavior, each paired with the shortest stable test. Runtime or E2E evidence is required only when a real boundary owns the behavior.

Does this planning workflow modify GitHub issues or source code?

No, planning is read-only by default and never edits source or publishes pull requests. GitHub writes such as labels or comments occur only after explicit user authorization, an exact preview, and are limited to the single approved write.

What GitHub access is required to plan a NemoClaw issue?

The workflow needs a configured read-only GitHub tool, GitHub MCP tool, or authenticated gh CLI to fetch the issue. If none is available, it stops with setup guidance instead of falling back to curl, web search, or other endpoints.

When should I not use the issue-planning workflow?

Do not use it for implementation requests, pull request publication, maintainer loops, or design discussions without a named issue. Ambiguous requests like "work on this issue" should first be clarified as planning or implementation.