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

The canonical home for this skill is llm-friendly-context in shinpr/claude-code-workflows

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 solid instruction-only skill body: concrete rewrite rules, verifiable checklists, and disciplined token usage with no filler or explained background. It falls short of top marks for occasional convoluted phrasing, sparse worked examples, and two overlapping checklists whose relative roles are not distinguished.

Suggestions

Trim rule-specific tangents (e.g., the 'explicit user diff limit' sentence in Keep constraints proportionate) and simplify jargon-heavy phrasing like 'reversible repository-local choices when governing evidence resolves them'.

Add one or two full before/after rewrite examples in Rewrite Patterns so the target shapes are directly copyable rather than described.

Clarify when each checklist applies — e.g., state that the Generated Artifact Checklist runs while drafting and the Handoff Checklist runs at transmission — or merge overlapping items to remove ambiguity.

DimensionReasoningScore

Conciseness

The body is dense and teaches nothing Claude already knows, with a compact rewrite table and terse checklists; however, a few trimmable items remain — the niche 'An explicit user diff limit is a constraint; otherwise necessary corrections are not bounded by a line count' sentence and convoluted phrasing like 'reversible repository-local choices when governing evidence resolves them' — fitting 'minor instances of over-explanation that could be trimmed'.

4 / 5

Actionability

The Rewrite Patterns table maps concrete ambiguous forms to specific rewrites (e.g., '`as needed` / `if needed` → The triggering condition and required action') and the checklists are verifiable line items, but only one worked example ('Preserve existing public API behavior...') is given and rewrites describe target shapes rather than full before/after pairs — 'mostly executable guidance with minor gaps'.

4 / 5

Workflow Clarity

An implicit apply-rules → rewrite → verify sequence exists with explicit checkpoints ('Before sending a prompt or artifact to another consumer, verify:'), and this is not a destructive or batch skill so no cap applies; the ordering and applicability of the two overlapping checklists (Handoff vs. Generated Artifact) is slightly ambiguous, fitting 'clear sequence with most checkpoints present; minor gaps'.

4 / 5

Progressive Disclosure

With no bundle files, all content lives inline in a well-organized four-section structure (Core Rules, Rewrite Patterns, Handoff Checklist, Generated Artifact Checklist); at ~84 lines it exceeds the under-50-line simple-skill exception, and the two checklists could plausibly live as separate reference files, fitting 'good structure; most content appropriately placed'.

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: it states a clear purpose with enumerated concrete objects and an explicit, well-scoped 'Use when' clause covering the skill's artifact types. Its only weaknesses are single-verb action coverage and a few broad trigger terms ('reviews', 'reports') that could collide with unrelated skills.

DimensionReasoningScore

Specificity

Enumerates five concrete objects — 'inputs, outputs, success criteria, decisions, and unresolved conditions' — giving specific coverage, though all hang off the single verb 'Clarifies' rather than multiple distinct actions, matching the 'several specific actions; minor gaps' anchor.

4 / 5

Completeness

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

5 / 5

Trigger Term Quality

'prompts, handoffs, planning artifacts, reviews, reports, generated instructions' are phrases users would naturally say, but common synonyms like 'specs', 'documentation', or 'agent instructions' are missing, fitting 'good keyword coverage; a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

The 'LLM-facing' and 'downstream consumers' framing carves a clear niche, but broad triggers like 'reviews' and 'reports' create minor overlap risk with general writing and code-review skills, fitting 'mostly distinct; minor overlap risk'.

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-workflows-frontend/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.