Create a framing document from conversation transcripts. Use when the user has transcripts (VTT, call notes, etc.) and wants to produce a frame that captures the problem worth solving and why it was chosen over alternatives.
86
83%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Risky
Do not use without reviewing
Quality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-structured description with explicit 'Use when...' guidance and good trigger term coverage. The main weakness is limited specificity in describing the concrete actions performed beyond the high-level 'create' verb. The description effectively carves out a distinct niche combining transcript processing with strategic framing output.
Suggestions
Add 2-3 more specific actions to describe the process, e.g., 'Analyzes conversation transcripts to extract key insights, identifies the core problem discussed, and synthesizes why it was chosen over alternatives.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (framing documents from transcripts) and describes the output (frame capturing problem and alternatives), but doesn't list multiple concrete actions beyond 'create'. Could specify steps like 'extract key insights, identify problem statements, synthesize alternatives discussed'. | 2 / 3 |
Completeness | Clearly answers both what ('Create a framing document from conversation transcripts') and when ('Use when the user has transcripts (VTT, call notes, etc.) and wants to produce a frame'). Has explicit 'Use when...' clause with specific trigger conditions. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'transcripts', 'VTT', 'call notes', 'framing document', 'frame', 'problem worth solving'. Good coverage of input formats and output types. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche combining transcript input with framing document output. The specific mention of VTT files, call notes, and the unique output format (problem framing with alternatives) makes it unlikely to conflict with general document or transcript skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, actionable skill that provides clear guidance for creating framing documents from transcripts. Its strengths are the concrete document template, explicit review checklist, and clear workflow. The main weakness is verbosity—some concepts are over-explained or repeated, and the document could benefit from splitting detailed reference material into separate files.
Suggestions
Tighten the 'Common traps to avoid' section—Claude understands these anti-patterns from the positive guidance already given
Consider moving the full document format template to a separate TEMPLATE.md file and referencing it
Consolidate the evidence-tracing guidance that appears in both 'Key Discipline' and 'Reviewing the Frame' sections
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient but includes some unnecessary explanation. Sections like 'Common traps to avoid' and the detailed explanation of 'Less about / More about' could be tightened. Some guidance is repeated (evidence tracing appears in multiple places). | 2 / 3 |
Actionability | Provides concrete, specific guidance throughout. The document format template is copy-paste ready, the review checklist is explicit, and the 'Before You Start' questions give exact steps. Each section has clear deliverables. | 3 / 3 |
Workflow Clarity | Clear sequence from gathering transcripts → drafting sections → reviewing with explicit validation. The review section provides a concrete feedback loop (read bullet → ask for evidence → cite or drop). Steps are well-ordered and checkpoints are explicit. | 3 / 3 |
Progressive Disclosure | Content is well-organized with clear headers, but this is a long monolithic document (~200 lines) that could benefit from splitting detailed guidance (e.g., 'Common traps' or the full template) into separate reference files. No external references are provided. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
7d8c311
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.