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.
68
83%
Does it follow best practices?
Impact
—
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-crafted description that clearly defines a specific niche (creating framing documents from transcripts), includes an explicit 'Use when' clause with concrete trigger terms like 'VTT' and 'call notes', and is distinctive enough to avoid conflicts with other skills. The main area for improvement is listing more specific sub-actions to better convey the full range of what the skill does beyond the high-level output.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (framing documents from transcripts) and describes the core action (create a framing document that captures the problem worth solving and why it was chosen over alternatives), but doesn't list multiple concrete sub-actions like extracting themes, summarizing alternatives, or structuring sections. | 2 / 3 |
Completeness | Clearly answers both 'what' (create a framing document that captures the problem worth solving and why it was chosen over alternatives) and 'when' (explicit 'Use when' clause specifying transcripts like VTT or call notes and the desire to produce a frame). | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms: 'framing document', 'conversation transcripts', 'VTT', 'call notes', 'problem worth solving', 'alternatives'. These cover multiple natural ways a user might describe this task and include specific file format mentions. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — the combination of 'framing document', 'conversation transcripts', and 'problem worth solving' creates a very specific niche that is unlikely to conflict with general summarization or document creation 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 strong instruction-only skill that provides genuinely novel methodology for a specific task. Its greatest strengths are actionability (concrete template, clear evidence-tracing discipline, structured review process) and workflow clarity (well-sequenced with validation checkpoints). The main weakness is verbosity in explanatory sections — particularly around the optional 'Less about / More about' section and the traps-to-avoid list — which could be tightened without losing clarity.
Suggestions
Tighten the 'Less about / More about' explanation — the 'When to include it,' 'How it surfaces,' and 'What it does' subsections could be condensed to 2-3 sentences total since the example already makes the concept clear.
Consider condensing 'Common traps to avoid' into a tighter checklist format (e.g., '- Don't infer causation nobody stated' rather than multi-sentence explanations with examples).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and covers genuinely novel methodology (framing from transcripts), but some sections are verbose — particularly the 'Less about / More about' explanation which spends ~150 words explaining when and how the section surfaces, and the 'Common traps to avoid' section over-explains with examples that could be tighter. The 'What This Skill Does NOT Do' section also restates things already clear from context. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance: a specific document template with markdown format, explicit review steps (read each bullet → ask for evidence → cite or drop), a structured options table format, and clear criteria for inclusion/exclusion of content. The guidance is specific enough to produce a consistent output without being code-based. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced: gather inputs → read transcripts → draft sections (Source → Pre-work → Problem/Outcome → optional Less/More about) → review every line against evidence criteria → shrink where needed. The review section serves as an explicit validation checkpoint with a clear feedback loop (no evidence → drop the line). | 3 / 3 |
Progressive Disclosure | The content is well-structured with clear headers and logical sections, but it's a long monolithic document (~700 words of guidance before the template). The 'Less about / More about' explanation and the 'Common traps' section could potentially be split into reference files. However, there are no external file references, and the document doesn't point to any supplementary materials. | 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.
d8b65d7
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.