CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

analyze-project

Forensic root cause analyzer for Antigravity sessions. Classifies scope deltas, rework patterns, root causes, hotspots, and auto-improves prompts/health.

Quality

68%

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

Quality

Content

63%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 a well-sequenced, largely actionable analysis workflow with explicit taxonomies, scoring rules, and a report structure, and it avoids teaching Claude things it already knows. Its weaknesses are repetition of the evidence/confidence mandate, an inlined ~85-line report template that belongs in a reference file, and underspecified derivation rules for some severity components.

Suggestions

Move the Step 10 report template and the Step 6.5 severity-scoring rubric into reference files (e.g. references/report-template.md, references/severity.md) and keep SKILL.md an overview, improving both progressive disclosure and token efficiency.

State the evidence+confidence and evidence-precedence requirements once in Global Rules and remove the per-step restatements in Steps 4, 5, 6, 6.5, and 9.

Define derivation rules for the severity sub-components (e.g. how 'Replanning intensity: 0-15' maps from plan/task versions) and specify exactly what counts as 'first-shot success' and 'replan rate'.

DimensionReasoningScore

Conciseness

The body is dense procedural instruction with almost no explanation of concepts Claude already knows, but it could be tightened: the evidence+confidence mandate is restated in nearly every step, the human/necessary/agent scope taxonomy appears in Global Rules, Step 4, and Step 10, and an ~85-line report template is inlined. This fits 'mostly efficient but could be tightened' better than the minor-trims anchor, and there is no concept over-explanation that would push it to 2.

3 / 5

Actionability

As an instruction-only skill the guidance is concrete: exact field names to record, explicit classification taxonomies, a clamped 0-100 severity formula with component ranges and bands, and a complete report template. Minor gaps remain — severity sub-components (e.g. 'Replanning intensity: 0-15') lack derivation rules, and 'first-shot success' is never defined — so it does not reach fully-executable level 5.

4 / 5

Workflow Clarity

Steps 0.5-11 are clearly sequenced, each with defined outputs, and the Final Output Standard plus per-diagnosis evidence/confidence requirements act as validation checkpoints. It is not 5 because some sub-scoring rules are underspecified and there is no re-verify loop over the produced report; the destructive/batch cap does not apply since this is a read-only analysis workflow with evidence requirements present.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent); the entire ~425-line skill lives in SKILL.md. It is well-structured with step headers, but content that belongs in separate reference files — the Step 10 report template and the severity scoring rubric — is inlined, matching the some-structure-but-content-should-be-separate anchor rather than the well-split anchor.

3 / 5

Total

14

/

20

Passed

Description

58%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 clearly states what the skill does with several concrete classification actions, and the Antigravity-specific niche keeps conflict risk low. Its main gaps are the complete absence of 'Use when...' trigger guidance (which caps completeness at 3) and missing natural user phrasings that would help the skill surface when needed.

Suggestions

Add an explicit 'Use when...' clause naming natural triggers, e.g. 'Use when the user wants to review or analyze past Antigravity sessions, run a post-mortem on why a session went wrong, or improve session prompts and project health.'

Include natural synonyms users would actually say — 'session review', 'session analysis', 'post-mortem', 'retrospective' — alongside analyst terms like 'scope deltas' and 'rework patterns'.

Replace the vague 'auto-improves prompts/health' with concrete outcomes, e.g. 'updates project-health/memory artifacts and generates prompt improvement tips from past sessions'.

DimensionReasoningScore

Specificity

Names the domain ('Antigravity sessions') and lists several concrete actions ('Classifies scope deltas, rework patterns, root causes, hotspots, and auto-improves prompts/health'), matching the several-specific-actions anchor. It is not 5 because 'auto-improves prompts/health' is fuzzy and the skill's primary output (report generation) is unmentioned; it is above 3 because more than 1-2 concrete actions are listed.

4 / 5

Completeness

The 'what' is clear (forensic root-cause classification across scope, rework, hotspots, plus auto-improvement), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords exist ('root cause', 'hotspots', 'rework patterns'), but the description leans on analyst jargon and misses natural phrases a user would say, such as 'session review', 'session analysis', 'post-mortem', or 'retrospective'. This fits 'some relevant keywords but missing common variations or synonyms' rather than the good-coverage anchor.

3 / 5

Distinctiveness Conflict Risk

'Antigravity sessions' frames a specific niche with distinct triggers and low conflict risk; only minor overlap risk exists with generic analysis/debugging/review skills, and 'auto-improves prompts/health' is the one somewhat generic phrase. It does not reach 5 because the description offers no trigger phrasing that would disambiguate it from adjacent session-analysis skills at invocation time.

4 / 5

Total

14

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

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