CtrlK
BlogDocsLog inGet started
Tessl Logo

project-skill-audit

Audit a project and recommend the highest-value skills to add or update.

56

Quality

64%

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/project-skill-audit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 content is a well-structured, actionable instruction skill with clear sequencing and good token efficiency. Its main gap is the absence of an explicit validation feedback loop, keeping workflow clarity at 4 rather than 5.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence and avoids explaining basic concepts, but the "What To Scan" section restates paths already detailed in the Workflow steps, leaving minor trimming opportunities short of a fully lean 5.

4 / 5

Actionability

It gives concrete, executable guidance including specific paths ($CODEX_HOME/memories/MEMORY.md), a tool (rg), file locations, and ordering rules, with only minor gaps such as no example search command.

4 / 5

Workflow Clarity

A clear numbered sequence (Workflow 1-7, Session Analysis 1-4) with explicit ordering and fallback rules, but it lacks an explicit validate->fix->retry feedback loop that would warrant a 5.

4 / 5

Progressive Disclosure

The skill is a single self-contained file with no external references needing structure, is organized into clear well-signaled sections (Overview, When to Use, Workflow, Failure Shields, Output), and cleanly hands off to skill-creator, matching the simple-skill exception for a 5.

5 / 5

Total

17

/

20

Passed

Description

50%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 the skill's purpose clearly but lacks any explicit trigger guidance and uses no natural user phrasings. It sits at the middle of the scale across all four dimensions.

Suggestions

Add an explicit trigger clause such as "Use when the user asks what skills a project needs or which existing skills should be updated."

Include natural user-facing phrasings (e.g. "skill suggestions", "what skills does this project need") to improve trigger-term quality.

Tighten the niche (e.g. "recommend highest-value skills grounded in project history and memory") to reduce overlap with generic audit skills.

DimensionReasoningScore

Specificity

Names the domain ("Audit a project") and two concrete actions ("recommend the highest-value skills to add or update"), matching the anchor that names the domain with 1-2 concrete actions; it does not list multiple specific actions needed for a 4.

3 / 5

Completeness

It clearly states what the skill does ("Audit a project and recommend... skills") but includes no "Use when..." trigger clause, so per the boundary guidance a missing explicit trigger caps completeness at 3.

3 / 5

Trigger Term Quality

Keywords like "audit," "recommend," and "skills to add or update" are relevant, but common natural user phrasings (e.g. "what skills does this project need") are missing, matching the anchor with some relevant keywords but missing common variations.

3 / 5

Distinctiveness Conflict Risk

The skills-audit niche is fairly distinct, but the phrase "Audit a project" is broad enough to overlap with generic project-audit skills, matching the anchor for somewhat specific with residual overlap risk.

3 / 5

Total

12

/

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.

Validation14 / 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: 1 suspicious

Warning

Total

14

/

16

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.