workshop-question-framing

Use this skill when reviewing, designing, or improving a workshop, lesson, training session, facilitation plan, talk, or educational explanation. Use it when the user provides a topic, concept, or explanation and wants better framing questions, curiosity hooks, opening prompts, discussion questions, learner reflection prompts, or ways to make participants think before being taught.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable instruction skill with a clear multi-step workflow, a worked example, and disciplined one-level-deep reference usage. The only dimension with room to improve is conciseness, where a small amount of framing prose could be trimmed.

Suggestions

Tighten the Purpose and Core Principle sections — they overlap in making the 'create a felt need / do not start with the explanation' point, which could be merged into a single concise statement.

The inline Worked Example duplicates the Output Format structure filled in; consider noting it is the canonical filled template and trimming any redundant framing around it to recover tokens.

Dimension	Reasoning	Score
Conciseness	Efficient and free of padding about concepts Claude already knows; its length comes from concrete methodology and a full worked example. Minor instances of over-explanation remain — the Purpose and Core Principle prose overlap slightly and could be tightened without loss.	4 / 5
Actionability	Highly actionable for an instruction-only skill: each question category specifies counts and example phrasings, the Output Format is a copy-paste template, and the fully worked magnet example demonstrates the complete end-to-end output.	5 / 5
Workflow Clarity	A clear six-step sequence is paired with input-handling decision logic (ask a follow-up only when no core concept is identifiable; otherwise infer and label as an assumption) and a final Quality Check that includes a revise-if-weak loop ('If not, revise it').	5 / 5
Progressive Disclosure	The body keeps the method, output template, and one worked example inline while offloading the detailed stimulus-and-question library to a single one-level-deep, well-signaled reference (./references/curiosity-by-design.md, verified present) with clear statements of what it contains.	5 / 5
	Total	19 / 20 Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, explicit description that clearly states capability and trigger conditions with comprehensive, natural keyword coverage. Its only weakness is a somewhat broad domain surface that could occasionally overlap with generic teaching-planning skills.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions and deliverables — 'reviewing, designing, or improving a workshop, lesson, training session…' and 'better framing questions, curiosity hooks, opening prompts, discussion questions, learner reflection prompts' — giving comprehensive coverage of the skill's outputs.	5 / 5
Completeness	Explicitly answers both 'what' ('reviewing, designing, or improving…') and 'when' via two concrete 'Use… when' clauses naming the user inputs and desired outputs.	5 / 5
Trigger Term Quality	Covers natural terms a facilitator would actually say with strong synonym coverage — workshop, lesson, training session, facilitation plan, talk, framing questions, curiosity hooks, opening prompts — plus the natural phrase 'make participants think before being taught'.	5 / 5
Distinctiveness Conflict Risk	The curiosity-hooks / think-before-being-taught framing carves a clear niche, but the broad domain list (workshop, lesson, training session, talk, educational explanation) creates minor overlap risk with general lesson-planning or pedagogy skills, so it sits just below the top anchor.	4 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: Jamie-BitFlight/claude_skills
Path: .agents/skills/workshop-question-framing/SKILL.md
Commit: 3e0b2af

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.