CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

llm-friendly-context

Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream consumers can execute without guessing. Use when writing or revising LLM-facing prompts, handoffs, planning artifacts, reviews, reports, or generated instructions.

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

75%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, instruction-only skill body with genuinely actionable rewrite patterns and validation checklists, and no wasted conceptual explanation. It falls short of top marks on explicit workflow sequencing (rules vs. rewrites vs. checklists ordering is implied) and on providing worked before/after examples.

Suggestions

Add one or two fully worked before/after examples showing a vague handoff rewritten using the Rewrite Patterns table, so the abstract rewrite targets like 'the governing constraint or unresolved owner decision' become concrete.

State the order of application explicitly (e.g., 1. apply Core Rules, 2. run Rewrite Patterns, 3. run the matching checklist) and say when to use the Handoff Checklist versus the Generated Artifact Checklist.

Remove the verbatim duplication of the prohibition rule across both checklists and tighten self-restating sentences such as 'Sufficient means sufficient for the assigned action, not complete background'.

DimensionReasoningScore

Conciseness

The body contains no padding or explanations of concepts Claude already knows, but the prohibition rule is repeated verbatim in both checklists and some sentences restate themselves ("Sufficient means sufficient for the assigned action, not complete background"), leaving minor instances that could be trimmed.

4 / 5

Actionability

The Rewrite Patterns table (e.g., "`as needed` / `if needed` | The triggering condition and required action") and two verification checklists are concrete, executable guidance for an instruction-only skill, but only one worked example exists and some rewrite targets ("The governing constraint or unresolved owner decision") remain abstract.

4 / 5

Workflow Clarity

The two checklists provide explicit validation checkpoints ("Before sending a prompt or artifact to another consumer, verify:"), but the ~80-line skill spans core rules, rewrite patterns, and two checklists whose order of application and selection is only implied ("Use these rewrites before treating a prompt... as complete") rather than explicitly sequenced.

4 / 5

Progressive Disclosure

Sections are well organized (Core Rules, Rewrite Patterns, Handoff Checklist, Generated Artifact Checklist) with no buried references, but at 80+ lines the skill exceeds the simple self-contained case and keeps all material inline with no overview layer or split of the checklists and rewrite table into reference files.

4 / 5

Total

16

/

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 with an explicit what-and-when structure and enumerated trigger phrases. Its main limitation is that all capabilities funnel through a single verb ("clarifies") and the trigger list omits several natural synonyms a user might say.

DimensionReasoningScore

Specificity

The description enumerates five concrete objects of the core action ("Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions"), giving several specifics, but all hang off a single verb rather than multiple distinct actions, matching the 'several specific actions; minor gaps' anchor.

4 / 5

Completeness

It explicitly answers both what ("Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream consumers can execute without guessing") and when ("Use when writing or revising LLM-facing prompts, handoffs, planning artifacts, reviews, reports, or generated instructions") with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Trigger terms "prompts, handoffs, planning artifacts, reviews, reports, or generated instructions" give good natural-keyword coverage, but common variations users would actually say ("spec", "brief", "task instructions", "context") are missing, so it stops short of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche of LLM-facing downstream artifacts is mostly distinct, but the triggers "reviews" and "reports" create minor overlap risk with code-review and report-writing skills rather than being a fully clear niche.

4 / 5

Total

17

/

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

shinpr/claude-code-workflows

Path

dev-skills/skills/llm-friendly-context/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.