framing-doc

Create framing documents from conversation transcripts capturing problems and chosen priorities.

1.4k|91|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/rjs/shaping-skills --skill framing-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: framing-doc
Source: https://github.com/rjs/shaping-skills/tree/main/framing-doc
Command: npx skills add https://github.com/rjs/shaping-skills --skill framing-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turning raw conversation transcripts (VTT files, call notes) into a structured framing document is slow and error-prone. This Skill distills transcripts into a frame that captures the problem worth solving, the options that surfaced, and why one was chosen over the others — while keeping every claim traceable to what was actually said.

Core Features & Use Cases

  • Source Capture: Extracts verbatim, attributed quotes from transcripts as ground truth for the document.
  • Options Landscape: Surveys the options that surfaced across conversations with honest signal-strength assessment, then argues why one is the priority now.
  • Problem/Outcome Framing: Produces scannable bullet lists of the problem and desired outcome, with an optional Less about / More about boundary section.
  • Evidence Discipline: Enforces a review pass where every claim must be traceable to a quote, marked as implied, or dropped.
  • Use Case: After a series of stakeholder calls about an onboarding redesign, feed the transcripts to this Skill to produce a frame document your team can align on before shaping solutions.

Quick Start

Use the framing-doc skill to turn these three call transcripts into a framing document about the onboarding redesign.

Frequently Asked Questions about framing-doc

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

FAQPage Schema
How do I turn meeting transcripts into a framing document?

Provide the transcript file paths and the topic area, and the Skill reads them in order, extracts attributed quotes, surveys the options that surfaced, and produces a frame with Problem, Outcome, and an optional Less about / More about section.

What transcript formats does the framing document skill accept?

It works with text-based transcripts such as VTT files and call notes. You specify the file paths and the reading order, since conversation order often matters when ideas build across calls.

Does the framing document evaluate whether ideas are good?

No. It formats and distills what was said without judging whether the material is reasonable. The output quality depends entirely on the quality of the input conversations.

What is the difference between a framing document and a shaping document?

The frame captures the why — the problem, the outcome, and why this option now. It explicitly does not shape solutions or sequence future work; shapes (the how) come later in a separate shaping document.

When should I include the Less about / More about section?

Include it when conversations show people actively drawing a line about what the project is not, or when an obvious-but-wrong solution direction exists. If nobody drew that boundary, the section is usually unnecessary.