CtrlK
BlogDocsLog inGet started
Tessl Logo

create-agents-md

Create AGENTS.md files for project-specific inline rules. Use when adding small, project-specific instructions that should be committed in repos.

84

Quality

80%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/create-agents-md/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

75%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description is functional with a clear 'Use when...' clause and distinctive focus on AGENTS.md files. However, it could benefit from more specific actions beyond 'create' and additional trigger terms that users might naturally use when seeking this functionality.

Suggestions

Expand the action list to include variations like 'create, edit, or update AGENTS.md files'

Add more natural trigger terms users might say, such as 'agent config', 'Claude project rules', 'inline instructions', or 'repository-level guidance'

DimensionReasoningScore

Specificity

Names the domain (AGENTS.md files, project-specific inline rules) and one action (create), but lacks comprehensive actions like 'edit', 'update', or 'configure'. The phrase 'adding small, project-specific instructions' provides some context but remains somewhat vague.

2 / 3

Completeness

Clearly answers both what ('Create AGENTS.md files for project-specific inline rules') and when ('Use when adding small, project-specific instructions that should be committed in repos') with an explicit 'Use when...' clause.

3 / 3

Trigger Term Quality

Includes relevant terms like 'AGENTS.md', 'project-specific instructions', and 'repos', but misses common variations users might say such as 'agent config', 'Claude instructions', 'project rules', or 'repository guidelines'.

2 / 3

Distinctiveness Conflict Risk

The specific mention of 'AGENTS.md files' creates a clear niche that is unlikely to conflict with other skills. The combination of file type and purpose (project-specific inline rules for repos) is distinctive.

3 / 3

Total

10

/

12

Passed

Implementation

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured skill that efficiently explains when and how to create AGENTS.md files. It excels at conciseness and organization, clearly distinguishing use cases from anti-patterns. The main weakness is that the actionability could be improved with more specific, scenario-based examples.

Suggestions

Add 1-2 more concrete AGENTS.md examples for specific scenarios (e.g., a test directory AGENTS.md, a monorepo package AGENTS.md) to improve actionability

DimensionReasoningScore

Conciseness

The content is lean and efficient, using bullet points and short sections. It assumes Claude understands markdown, repos, and project structures without explaining basics.

3 / 3

Actionability

Provides a concrete example of AGENTS.md structure and clear guidance on when to use it, but the example is somewhat generic. Could benefit from more specific, copy-paste-ready templates for common scenarios.

2 / 3

Workflow Clarity

For this simple, single-purpose skill, the workflow is clear: decide when to use AGENTS.md, choose location, follow the structure. No multi-step validation needed for creating a markdown file.

3 / 3

Progressive Disclosure

Well-organized with clear sections, appropriate length for the topic, and a single reference to detailed best practices. Content is appropriately scoped without being monolithic.

3 / 3

Total

11

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
siviter-xyz/dot-agent
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.