CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

kickoff-doc

Turn a shaped project kickoff transcript into a reference document for the builder. Use when the user has a transcript (VTT, etc.) from a kickoff call and wants to produce a document that captures what was shaped and agreed.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

85%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-crafted instruction-only skill: it teaches genuinely non-obvious project conventions, specifies the output structure exactly, and closes with a validation step and remediation rule. The only refinements worth making are removing the duplicated build-sequence and territory statements and optionally adding a short example output skeleton.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it teaches only project-specific conventions (Frame/Shape structure, territory-vs-timeline, vertical design decisions) with no explanations of known concepts. Minor trimming is possible: the build-sequence prohibition appears in both "Organizing Principle" ("Do NOT organize by build sequence") and "Structure" ("Do NOT include a Build Sequence section"), and "map of the territory" is stated twice, which keeps it below anchor 5.

4 / 5

Actionability

Guidance is concrete and executable: exact heading hierarchy ("## Frame" with "### Problem" and "### Outcome"; one "###" per area under "## Shape"), per-section content checklists, and worked placement examples ("'Matches stored in DB not Redis' → goes in the section about matching"). Per the rubric's scoring notes, the absence of code in an instruction-only skill is not penalized; it falls short of anchor 5 only because no example output or template is provided.

4 / 5

Workflow Clarity

The Process section gives a clear 6-step sequence with an explicit validation checkpoint — "6. Review against the transcript — can you point to where each claim was said?" — and "The Test" supplies the pass criterion plus an error-recovery loop ("If you can't, either cut it or flag it as your own synthesis"). This matches the anchor-5 pattern of sequence + explicit validation + feedback loop, and the skill involves no destructive or batch operations requiring additional safeguards.

5 / 5

Progressive Disclosure

The skill is a single self-contained SKILL.md (~95 lines) with no references/, scripts/, or assets/ directories, and nothing in the body points to bundle files — nothing that clearly belongs in a separate file is inlined. Sections are well-organized with clear headings, so navigation is trivial and content is appropriately placed for a skill of this scope.

5 / 5

Total

18

/

20

Passed

Description

78%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 description with an explicit and concrete "Use when..." trigger clause, natural keywords including a file-format variant, and a clearly defined niche. The main gap is that it describes a single transformation action rather than enumerating several concrete capabilities.

DimensionReasoningScore

Specificity

"Turn a shaped project kickoff transcript into a reference document for the builder" names the domain precisely (shaped kickoff transcript, builder-facing reference document) and one concrete transformation, but does not list several distinct actions like the anchor-4 example. It clearly exceeds anchor 2, which only names a domain with minimal action.

3 / 5

Completeness

The description explicitly answers both questions: "what" ("Turn a shaped project kickoff transcript into a reference document for the builder") and "when" ("Use when the user has a transcript (VTT, etc.) from a kickoff call and wants to produce a document that captures what was shaped and agreed") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural terms a user would say are present — "transcript (VTT, etc.)", "kickoff call", "kickoff transcript", "shaped and agreed" — including a file-format variant. A few common synonyms ("recording", "meeting") are missing, so it does not reach the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — converting a shaped-project kickoff call transcript into a builder reference document — with distinct triggers ("kickoff", "VTT", "shaped"). Minor overlap remains with generic meeting-summarization or documentation skills, keeping it just below anchor 5.

4 / 5

Total

16

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

rjs/shaping-skills

Path

kickoff-doc/SKILL.md

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.