CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ai-md

Convert human-written CLAUDE.md into AI-native structured-label format. Propose and evaluate structured-label rewrites while preserving rule meaning; benefits require measured evidence.

Quality

66%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/ai-md/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 an exemplary lean overview with verified, well-structured one-level-deep progressive disclosure, but it delegates essentially all executable substance to the reference file. A reader of SKILL.md alone gets no quick-start, commands, or validation steps, which drags actionability down despite the excellent structure.

Suggestions

Add a compact inline quick-start summarizing the two-stage workflow (measure/preview, then convert with backup) so the core procedure is visible without loading the guide.

Inline the critical safety commands — the backup/restore cp commands and the mandatory validation checkpoint — since the skill overwrites a live CLAUDE.md.

Include one short before/after example rewrite in the body so users (and Claude) can see the target structured-label format immediately.

DimensionReasoningScore

Conciseness

The body is lean with no concept explanations or padding — every line is scope, navigation, or a guardrail ("Use when your CLAUDE.md is long but AI still ignores your rules", "Stop and ask for clarification if required inputs... are missing"). Nothing identifiable could be trimmed, so it is above level 4.

5 / 5

Actionability

The only executable directive in the body is "Read [the detailed guide](references/detailed-guide.md) before executing this skill" — the concrete steps, commands, and example rewrites all live one level away in the reference. This matches "minimal concrete guidance; high-level hints but missing the specific steps to execute". Not level 3 because the body contains no inline quick-start, example, or command; not level 1 because the pointer is a specific, real instruction plus concrete stop conditions.

2 / 5

Workflow Clarity

The sequence in the body is only "read the guide → execute", and while validation is declared ("Treat its safety, prerequisites, and validation requirements as mandatory"), no actual checkpoint appears in the body. Since the skill's operation replaces a user's live CLAUDE.md (destructive-adjacent) and the body itself lacks validation steps, workflow clarity is capped at 3. Not level 4 because checkpoints are delegated rather than present; not level 2 because the delegation is explicit and the stop-and-ask conditions give a rough but stated frame.

3 / 5

Progressive Disclosure

Verified against the actual bundle: the single reference references/detailed-guide.md exists, is clearly signaled with a markdown link, is one level deep, and itself contains no nested references. The body is a clean overview (guide pointer, when-to-use, limitations) with trivial navigation. Not level 4 because the split is appropriate and there are no organization gaps to point to.

5 / 5

Total

15

/

20

Passed

Description

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

The description states a clear, distinct capability with a specific artifact trigger, but it lacks any "when to use" guidance and natural trigger phrasings beyond "CLAUDE.md". It reads as a competent capability statement rather than an activation-ready description.

Suggestions

Add an explicit "Use when..." clause, e.g. "Use when your CLAUDE.md is long, token-heavy, or rules are being ignored, or when migrating rules between AI tools (Claude, Codex, Gemini, Grok)."

Include natural trigger terms and synonyms users would actually say: "system prompt", "reduce token usage", "optimize rules", "CLAUDE.md rewrite".

Briefly enumerate the concrete deliverables (measured before/after comparison, backup and restore, multi-model validation) to lift specificity from domain-plus-two-actions to comprehensive coverage.

DimensionReasoningScore

Specificity

"Convert human-written CLAUDE.md into AI-native structured-label format" and "Propose and evaluate structured-label rewrites" name the domain plus 1-2 concrete actions, but coverage of the full workflow (measuring, testing, migrating) is absent. It is above level 2 because the actions are concrete rather than generic, but below level 4 because it does not list several specific actions.

3 / 5

Completeness

The "what" is clear (convert CLAUDE.md to structured labels; propose and evaluate rewrites), but there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3. Not level 4 because "when" is entirely missing rather than merely imprecise.

3 / 5

Trigger Term Quality

"CLAUDE.md" is the one genuinely natural keyword, but common user phrasings like "system prompt", "reduce token usage", or "rules" are missing. Not level 4 because there is no synonym or variation coverage; not level 2 because the present keyword is specific to the artifact, not generic.

3 / 5

Distinctiveness Conflict Risk

"human-written CLAUDE.md" conversion is a clear niche with a distinct artifact trigger, giving minimal conflict risk. Not level 5 because the broader prompt-optimization scope creates minor overlap with generic prompt-engineering skills; not level 3 because the CLAUDE.md artifact keeps it well distinguished.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

sickn33/agentic-awesome-skills

Path

skills/ai-md/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.