sm:shape:brief

Rank top problems from shape skill outputs into a staged brief with inline proposals.

5|2|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/mnfst-ai/Stage_Manager_Skills --skill sm-shape-brief
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sm:shape:brief
Source: https://github.com/mnfst-ai/Stage_Manager_Skills/tree/main/plugins/stage-manager/skills/shape-brief
Command: npx skills add https://github.com/mnfst-ai/Stage_Manager_Skills --skill sm-shape-brief

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns scattered findings from one or more shape skills into a single, decision-ready handoff by ranking top problems, proposing concrete fixes, and preparing a staged spec and brief for the next tool or team.

Core Features & Use Cases

  • Cross-skill synthesis: Detects patterns across Find the Holes, Collapsed Options, Risk Sequence, and Soul Check outputs and elevates cross-cutting findings.
  • Prioritized fixes and inline proposals: Scores and ranks the top three problem areas, generates explicit inline change suggestions for builder acceptance, and enforces prompt-guard logic to avoid invention.
  • Handoff artifacts: Produces a Stage_Manager_Brief.md handoff and, after accepted changes, a [filename]-Staged.md ready for CE or Superpowers workflows.
  • Use Case: A builder pastes multiple shape-skill outputs and the original spec; the Skill returns ranked problems, proposed spec edits to accept/reject, and a build-ready brief.

Quick Start

Brief the accumulated shape skill outputs, propose inline change suggestions, and prepare Stage_Manager_Brief.md plus a staged spec pending your accept/reject responses.

Frequently Asked Questions about sm:shape:brief

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

FAQPage Schema
How do I synthesize multiple shape skill outputs into a decision-ready spec brief?

To synthesize shape skill outputs into a decision-ready spec brief, paste the accumulated findings from Find the Holes, Collapsed Options, Risk Sequence, and Soul Check alongside your original spec. The skill ranks the top three problems and generates inline change proposals.

What is the best way to prepare a staged spec handoff from scattered analysis findings?

Preparing a staged spec handoff requires synthesizing cross-cutting findings from prior shape skills into a ranked top-three problems brief. The process produces a Stage_Manager_Brief.md and a staged spec file, enforcing prompt-guard logic to prevent invented changes.

Can I apply proposed spec edits automatically without reviewing inline change suggestions?

You cannot apply proposed spec edits automatically because the system enforces prompt-guard checks and waits for explicit accept or reject decisions. This mechanism prevents unauthorized modifications and ensures the builder reviews every inline change proposal before staging.

How do I rank and prioritize problem areas from multiple product analysis outputs?

Ranking and prioritizing problem areas from multiple analysis outputs involves scoring cross-cutting findings detected across shape skills. The synthesis elevates the top three problem areas and pairs them with explicit inline change suggestions ready for builder acceptance.

When do I need a traceable Stage_Manager_Brief.md for my project handoff?

You need a traceable Stage_Manager_Brief.md when one or more shape skills have been run and the builder requires a decision-ready handoff. It bridges accumulated analysis and a staged spec, ensuring downstream CE or Superpowers workflows receive ranked priorities.