CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-context-file

Creates a structured, date-stamped context file filed by typology (findings, plans, goals, evidence, guides, follow-ups, merge-requests, tickets, decisions, notes, research) with YAML frontmatter. Use when saving a finding, writing a plan, capturing a guide, recording a decision, logging a follow-up, filing a merge-request note, capturing work as progression evidence, plus ticket write-ups.

Quality

83%

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

78%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.

The body is highly actionable and exceptionally well structured for progressive disclosure — executable commands with expected results inline, details correctly pushed to clearly signaled one-level-deep references. Its weakness is token efficiency: the anti-patterns section restates earlier sections and carries redundant Consequence lines, and the blocked-by guidance over-explains another skill's tooling.

Suggestions

Trim the anti-patterns section: drop or fold the "Consequence" lines into "WHY" (they largely restate each other), and cut the "NEVER emit `related: []`" and "NEVER write unconfirmed grades" entries that duplicate the Quick Commands expected results and the "Filing a follow-up" section.

Compress the blocked-by guidance: state the fail-closed rule once (a short principle plus a pointer to references/typologies.md's lifecycle column) instead of the current long explanation of `context-ready.sh` mechanics that appears in both Quick Commands and Anti-Patterns.

Add a brief recovery step to the workflow for when the step-2 duplicate check finds an existing file or the step-3 verification of the printed path fails, closing the last workflow-clarity gap.

DimensionReasoningScore

Conciseness

The body is mostly skill-specific and free of explanations of known concepts, but it is noticeably repetitive and could be tightened: the "NEVER emit `related: []`" and "NEVER write severity/priority/graded the user has not confirmed" anti-patterns restate the "Quick Commands" expected results and the "Filing a follow-up" section almost verbatim, each anti-pattern carries a "Consequence" line that largely restates its "WHY", and the blocked-by sections (both in Quick Commands and Anti-Patterns) explain `context-ready.sh` mechanics at cross-skill length. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the 'minor instances' of a 4.

3 / 5

Actionability

Every Quick Command is copy-paste-ready bash with concrete flags, tags, heredoc bodies, and `--dry-run`, and each is paired with an explicit "Expected result" so the outcome is checkable; the workflow step itself gives the exact `ls .context/findings/` inspection command. This matches 'fully executable; copy-paste ready commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The four-step workflow is clearly sequenced with explicit checkpoints ("Stop if: none fits...", "Verify: the printed path uses the expected typology plus date", "Stop if: the content spans two typologies; split it"), matching 'clear sequence with most checkpoints present'. It falls short of a 5 because there is no error-recovery feedback loop after the verification step (e.g., what to do if the printed path or duplicates check fails beyond the stop conditions), and duplicate-checking is shown for only one typology.

4 / 5

Progressive Disclosure

The body stays an overview: quick commands inline, with the full CLI detail, typology catalog, grading rubric, and frontmatter schema each split into a real bundle file (all four verified to exist) exactly one level deep, and every entry in the References section is annotated with a "load when..." signal for on-demand navigation. This matches 'clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'; cli.md's single cross-link to follow-up-grading.md is a see-also, not a content-chasing chain.

5 / 5

Total

17

/

20

Passed

Description

83%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: it pairs a concrete, multi-detail statement of what the skill does with an explicit 'Use when' clause covering most of its typologies in natural user language. The main gaps are a handful of missing natural trigger phrases and minor overlap risk on generic triggers like 'writing a plan'.

DimensionReasoningScore

Specificity

"Creates a structured, date-stamped context file filed by typology (findings, plans, goals...) with YAML frontmatter" names several concrete specifics of the action (date-stamping, typology filing, YAML frontmatter, a ten-entry typology catalog), matching the 'several specific actions; minor gaps' anchor rather than the 1-2-action anchor at 3. It is not a 5 because everything describes facets of a single create-file action and features like grading and cross-linking are unmentioned, leaving minor coverage gaps.

4 / 5

Completeness

It explicitly answers both questions: what ("Creates a structured, date-stamped context file filed by typology... with YAML frontmatter") and when ("Use when saving a finding, writing a plan, capturing a guide..."), with concrete trigger phrases throughout. This matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'; a 4 would require the 'when' clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

"Use when saving a finding, writing a plan, capturing a guide, recording a decision, logging a follow-up, filing a merge-request note, capturing work as progression evidence, plus ticket write-ups" gives good natural-phrase coverage across most typologies. A few natural terms are missing (e.g., 'take notes', 'document this', and trigger phrases for 'goals' and 'research' which appear only in the typology list), so it sits at 'good coverage, a few natural terms missing' rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The typology catalog and context-file framing carve a clear niche, but triggers like "writing a plan" and "recording a decision" could overlap with general planning or decision-record skills, giving minor overlap risk with closely related skills. Not a 5 ('minimal conflict risk') because several trigger phrases are generic enough to compete with adjacent documentation skills; not a 3 because the specific typology set and context-directory concept keep it mostly distinct.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 1 missing, 1 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

pantheon-org/tekhne

Path

skills/project-mgmt/create-context-file/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.