CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

update-llms-text

Update and maintain the llms.txt file. Use when the user wants to add sections, add links, correct information, or review the llms.txt file.

Quality

88%

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

86%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 tight, well-structured instruction skill: every action is concretely specified with an exact output format, and the file needs no bundle. The only improvement space is adding a lightweight verification step after edits and slightly tightening the open-ended placement/description steps.

DimensionReasoningScore

Conciseness

Lean and efficient with no padding or explanations of things Claude already knows; the single context sentence ('a curated resource list that helps LLMs understand the Flutter framework') earns its place, and every instruction is operational.

5 / 5

Actionability

Gives a concrete file path, an exact copy-paste link format ('- [Title](URL): Description.'), and per-action numbered steps; minor gaps remain in open-ended steps like 'Place the new section in a logical location' and 'determine an appropriate description', and no tool is named for the broken-link check during review.

4 / 5

Workflow Clarity

Each action has a clearly sequenced numbered procedure with an approval checkpoint on review ('don't make changes without approval'), but there is no post-edit verification step (e.g., re-checking the edited file or confirming links resolve).

4 / 5

Progressive Disclosure

A single small (~50-line) instruction skill with no need for external references; content is fully and appropriately inlined under well-organized sections (Actions, Formatting rules) with clear navigation.

5 / 5

Total

18

/

20

Passed

Description

87%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: concise, third-person, with an explicit 'Use when' clause and concrete enumerated actions tied to a distinctive file. Only minor gains available from adding synonyms like 'edit' or 'fix'.

DimensionReasoningScore

Specificity

Lists several concrete actions ('add sections, add links, correct information, or review the llms.txt file') against a named domain, though the leading 'Update and maintain' is slightly generic, leaving minor gaps in coverage.

4 / 5

Completeness

Explicitly answers both what ('Update and maintain the llms.txt file' with enumerated actions) and when ('Use when the user wants to add sections, add links, correct information, or review the llms.txt file') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases a user would say ('add sections', 'add links', 'correct information', 'review the llms.txt file') are present, but common synonyms like 'edit', 'fix', or 'update links' are missing.

4 / 5

Distinctiveness Conflict Risk

'llms.txt' is a clear niche target with distinct, file-specific triggers; minimal risk of firing for an unrelated skill.

5 / 5

Total

18

/

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

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

flutter/website

Path

.agents/skills/update-llms-text/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.