CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fastapi-code-review

Review checklist for correctness, regressions, and missing tests in the vault-memory FastAPI/async codebase — async pitfalls, FastAPI/DI/auth checks, and test-quality signals.

Quality

85%

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

93%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.

An exemplary concise review checklist: every line is a specific, executable check anchored to real identifiers in the codebase, organized into clear sections with a prioritized review order. The only minor gap is the absence of explicit completion/verification checkpoints in the review workflow.

DimensionReasoningScore

Conciseness

The body is a lean, dense checklist that assumes Claude already knows FastAPI and asyncio; it explains only non-obvious, project-specific rationale ("a not-yet-done task from a dead loop is never done") and every line is an actionable check. This matches 'lean and efficient; every token earns its place' — it is not the 4 anchor, which requires over-explanation to trim.

5 / 5

Actionability

Guidance names exact identifiers and idioms to execute: `app.dependency_overrides[get_dependencies]`, comparing `task.get_loop()` against `asyncio.get_running_loop()`, clearing task handles in `finally`, `_safe_vault_path`, monkeypatch-deleting `VAULT_MEMORY_API_KEY`, and `skipif(os.name == "nt")`. Per the scoring notes, an instruction-only skill without code is not penalized when the guidance is this concrete, so it meets 'fully executable... specific examples cover the common cases' rather than stopping at 'minor gaps'.

5 / 5

Workflow Clarity

The 'Review order' section gives a clear prioritized 1-2-3 sequence (correctness, regressions, missing tests) with concrete per-step criteria, but there are no explicit verification checkpoints (e.g., when findings are complete enough to report). This fits 'clear sequence with most checkpoints present; minor validation gaps' rather than the explicit validate/recover loops of a 5; the destructive-operation cap does not apply since this is a read-only review skill.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no external references needed (no references/, scripts/, or assets/ directories exist), and it is organized into four well-labeled sections. Per the judging guidelines, a short skill with no need for external references scores 5 with just well-organized sections.

5 / 5

Total

19

/

20

Passed

Description

71%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 specific, well-scoped description that clearly names what the skill reviews, but it completely lacks a 'when to use' trigger clause, which caps its completeness and limits its natural discoverability. Adding explicit usage triggers and user-facing synonyms would round it out.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when reviewing changes to the vault-memory FastAPI service, or when asked to review Python async/FastAPI code, PRs, or diffs.'

Include natural synonyms users would actually say — 'code review', 'PR review', 'Python' — to improve trigger coverage beyond the current single-pass phrasing.

Clarify whether the skill applies only to the vault-memory codebase or to FastAPI/async Python generally, so the codebase-specific 'vault-memory' term does not read as opaque jargon to a reviewer deciding whether to invoke it.

DimensionReasoningScore

Specificity

The description lists six concrete review areas ("correctness, regressions, and missing tests", "async pitfalls, FastAPI/DI/auth checks, and test-quality signals"), matching the anchor for multiple specific concrete actions with comprehensive coverage of its domain.

5 / 5

Completeness

There is a clear 'what' (a review checklist covering named checks), but no 'Use when...' clause or equivalent explicit trigger guidance — the 'when' is only weakly implied by the codebase name. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms like "Review", "regressions", "missing tests", "FastAPI", "async", and "auth" are present, but common variations users would say ("code review", "PR review", "Python", "pull request") are missing, and "vault-memory" is codebase-internal jargon. This fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive-synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

Scoping to "the vault-memory FastAPI/async codebase" gives a clear niche with minimal wrong-skill triggering, but generic terms like "review" and "missing tests" carry minor overlap risk with general code-review skills — 'mostly distinct; minor overlap risk' rather than the minimal-conflict 5.

4 / 5

Total

16

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

pvnkmnk/vault-memory

Path

.agents/skills/fastapi-code-review/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.