CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

project-skill-audit

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

Quality

67%

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

67%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 skill body delivers a concrete, well-sequenced audit workflow with specific paths, search keys, fallback rules, decision criteria, and failure shields — highly actionable for an instruction-only skill. Its main weaknesses are redundancy (the same locations and procedures restated across Workflow, Session Analysis, and What To Scan) and the absence of any reference files to absorb detail.

Suggestions

Consolidate the duplicated material: merge 'Session Analysis' sections 1-3 into Workflow steps 2-3 (or replace them with a pointer), and drop 'What To Scan' location lists that restate paths already given in the Workflow.

Add an explicit verification checkpoint before producing output, e.g., 'confirm every recommended skill/update cites at least one concrete piece of session or repo evidence' — this closes the validation gap in the workflow.

Consider moving the detailed session-analysis search heuristics (search keys, fallback criteria) into a single reference file to shorten SKILL.md and eliminate the dual numbered sequences for the same procedure.

DimensionReasoningScore

Conciseness

The body is written in dense, imperative prose with no explanations of concepts Claude already knows, but it repeats the same material multiple times: memory/rollout paths appear in Workflow steps 2-3, again in Session Analysis sections 1-3, and again in 'What To Scan'; the project-local skill locations from Workflow step 4 are restated in 'What To Scan'. This matches the score-3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened') — noticeable duplication, though not the padded over-explanation of score 2.

3 / 5

Actionability

The guidance is concrete and executable: exact paths ('$CODEX_HOME/memories/MEMORY.md', './.agents/skills/*/SKILL.md'), specific search keys (repo name, basename, cwd), explicit fallback rules, and a defined output format. It falls at score 4 ('mostly executable guidance with minor gaps') rather than 5 because there are no copy-paste-ready commands (e.g., the actual rg invocations) and some criteria like 'repeated enough' are left to judgment.

4 / 5

Workflow Clarity

The 7-step Workflow is clearly sequenced with explicit gating ("Open only the 1-3 most relevant rollout summaries first", "Fall back to raw session JSONL only when the summaries are missing the exact evidence"), and the Failure Shields section acts as an error-prevention checklist. It is not a 5 because the same analysis procedure appears as two separate numbered sequences (Workflow steps 2-5 and Session Analysis sections 1-4) with slightly different details, creating mild ambiguity about which governs, and there is no explicit verification step that each final recommendation cites concrete session evidence.

4 / 5

Progressive Disclosure

The body is well-organized into clearly signaled sections (Workflow, Session Analysis, Recommendation Rules, What To Scan, Output Expectations, Failure Shields) with no buried or nested references, and the only external link ([skill-creator](../skill-creator/SKILL.md)) is a legitimate one-level cross-skill pointer. It sits at score 4 rather than 5 because at ~190 lines all detail lives inline — the Session Analysis and What To Scan sections duplicate Workflow content that could be consolidated or moved to reference files — leaving minor organization gaps.

4 / 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, concrete purpose in third person without fluff, but it omits any 'when to use' trigger guidance and lacks natural trigger-term variations, both of which limit discoverability. Its niche is reasonably distinct from other skills.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g., 'Use when the user asks what skills a project needs, which existing skills are stale, or wants a skill-gap audit.'

Include natural trigger variations such as "skill gap analysis", "skill recommendations", and "skill inventory" to improve keyword coverage.

Briefly mention the evidence-based method (session history, memory files, repo conventions) to sharpen the 'what' and further distinguish it from generic skill-creation skills.

DimensionReasoningScore

Specificity

The description names the domain and two concrete actions ("Audit a project" and "recommend the highest-value skills to add or update"), but coverage is not comprehensive — the skill's distinctive evidence-based method (grounding recommendations in session history, memory, and repo conventions) is absent. It clearly matches the score-3 anchor ('names domain and 1-2 concrete actions, but not comprehensive') and is below score 4, which expects several listed specific actions with only minor gaps.

3 / 5

Completeness

The "what" is clear (audit a project, recommend skills to add or update), but there is no "Use when..." clause or equivalent trigger guidance anywhere in the description. Per the rubric guideline, a missing 'Use when...' clause caps completeness at 3, matching the anchor 'has a clear what but when is missing or only weakly implied'.

3 / 5

Trigger Term Quality

Relevant keywords like "audit", "project", "skills", and "add or update" are present and natural, but common variations users would say are missing (e.g., "skill gap", "which skills does this project need", "skill recommendations"). This fits the score-3 anchor ('some relevant keywords but missing common variations or synonyms'); it is above score 2 because the terms present are specific to this task, not generic.

3 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — auditing a project to recommend skills is unlikely to trigger for unrelated skills. There is minor overlap risk with skill-creation/skill-authoring skills (recommending vs. creating skills), matching the score-4 anchor 'mostly distinct; minor overlap risk with closely related skills'; it falls short of 5 because the description gives no trigger phrases that would disambiguate it from general skill-management requests.

4 / 5

Total

13

/

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

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/project-skill-audit/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.