skills.rest
bketelsen
bketelsenCOMMUNITY
Explore all skills by this author →
Website𝕏@bketelsenGitHub

refine-scope

Refine plans, epics, and stories by addressing ambiguity and feedback.

1|Updated Mar 12, 2026
Search Tags:#planning#feedback#refinement#discovery#scope#artefacts
One-click install
npx skills add https://github.com/bketelsen/truenas-mcp --skill refine-scope
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refine-scope
Source: https://github.com/bketelsen/truenas-mcp/tree/main/.gaai/core/skills/discovery/refine-scope
Command: npx skills add https://github.com/bketelsen/truenas-mcp --skill refine-scope

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses ambiguity and incompleteness in existing project artefacts, ensuring clarity and reducing uncertainty before execution.

Core Features & Use Cases

  • Iterative Refinement: Modifies plans, epics, and stories based on feedback and identified gaps.
  • Gap Identification: Pinpoints missing acceptance criteria, contradictions, or unclear scope.
  • Use Case: After initial planning, human feedback highlights that a user story's acceptance criteria are not testable. This Skill is activated to revise the criteria, making them clear and verifiable.

Quick Start

Use the refine-scope skill to update the acceptance criteria for story ABC-123 based on the provided feedback.

Frequently Asked Questions about refine-scope

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

FAQPage Schema
How do I refine user story acceptance criteria to make them testable?▼

To refine acceptance criteria for user stories, this Skill analyzes existing story artefacts for ambiguity and incorporates human feedback to produce updated, clearly verifiable criteria. It identifies gaps in the original plan and adjusts the scope to ensure testability.

How do I update project epics and plans based on new feedback?▼

Updating project epics and plans involves iterative refinement based on feedback to address detected incompleteness. This Skill modifies filesystem-based discovery artefacts, aligning evolving requirements with the project scope to reduce uncertainty before execution.

What is the best way to identify missing scope or contradictions in discovery artefacts?▼

Identifying missing scope and contradictions in discovery artefacts requires a targeted refinement process. This Skill pinpoints gaps in existing plans, epics, and stories, highlighting unclear scope and contradictions to improve overall clarity.

Can I use this to adjust scope for evolving requirements on filesystem-based plans?▼

Yes, you can adjust scope for evolving requirements on filesystem-based plans. This Skill operates directly on existing artefacts, refining them by addressing ambiguity and incorporating feedback to align with changing project needs.

How do I fix untestable acceptance criteria before development execution?▼

Fixing untestable acceptance criteria before execution requires refining the story scope to ensure verifiable conditions. This Skill revises existing criteria by addressing ambiguity and incorporating feedback to produce clear, testable definitions.

Related Skills

Explore More Product & Management Skills→
petrSimonidesXartpetrSimonidesXart

refine-scope

Identify gaps and ambiguities in discovery artefacts and produce a refined scope plan.

Community
Advanced
meirmmeirm
29

deriving-acceptance-criteria-from-business-logic

Convert business logic into acceptance criteria, user stories, and Gherkin scenarios.

Community
Intermediate
roderikroderik
2

ask-questions-if-underspecified

Clarify underspecified requests with 1-5 must-have questions before implementation.

Community
Basic
Fr-e-dFr-e-d
157

refine-scope

Refine Discovery artefacts by addressing ambiguity and missing acceptance criteria.

Community
Intermediate