CtrlK
BlogDocsLog inGet started
Tessl Logo

framing-doc

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

Quality

83%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

SKILL.md
Quality
Evals
Security

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.'

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
rjs/shaping-skills
Reviewed

Table of Contents

Is this your skill?

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.