CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

auditor

Auditor independiente. Toma T-{n}-result.md + corre tests él mismo (NO se fía del dev). Spawna agents auditor-{be,fe,agentic} según surface del ticket. Veredicto: APPROVED | CHANGES_REQUESTED | ESCALATED. Self-fix triviales (lint/typo/format) cap 2 iter. Diseño/security/arch → escala. Cuando todos tickets del story audit-passed, escribe REVIEW-final.md. Activa cuando user dice: '/auditor', 'auditá T-N', 'revisá ticket', 'verdict'.

72

Quality

91%

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

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

A lean, highly actionable orchestration procedure with concrete commands, spawn templates, and a well-validated multi-case workflow including feedback loops and escalation paths. The main improvement areas are de-duplicating the repeated self-fix cap rules and clarifying where the sub-auditor category and gate definitions live.

Suggestions

State the self-fix iteration cap once (e.g. in the Self-fix policy table) and reference it from Step 3 and the Anti-patterns list instead of repeating it three times.

Point to the actual location of the sub-auditor definitions (e.g. .claude/agents/auditor-{be,fe,agentic}.md) or the gate category catalogs so 'Score against your N categories' is resolvable.

Move or link the 'Self-fix policy detallada' section adjacent to Step 3 Caso C, where the self-fix decision is made, rather than after Step 5.

DimensionReasoningScore

Conciseness

The body is dense and procedural with tables, bare commands, and no explanation of concepts Claude already knows, but the self-fix iteration cap is stated three times (Step 3 Caso C, 'Cap absoluto: 2 self-fix iter por ticket', and the Anti-patterns list) and the self-fix policy is split across two sections. This is efficient content with minor redundancy that could be trimmed — the 4 anchor, not the lean-every-token-counts 5.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance: concrete bootstrap commands (git log, git diff HEAD~1 HEAD --stat), self-fix commands (ruff format, ruff check --fix, git add/commit/push), YAML ticket-state update snippets, and complete Agent spawn templates with prompts. Specific examples cover the common audit cases, matching the 5 anchor rather than the minor-gaps 4.

5 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced with explicit validation and feedback loops throughout: verdict processing split into four cases with iteration caps and escalation, a self-fix loop ('Re-correr quality gates → Si verde → APPROVED / Si falla → CHANGES_REQUESTED'), a dev fix → push → re-audit loop, and mandatory end-to-end verification before merge, plus an anti-patterns checklist. This matches the 5 anchor's explicit validation steps with error-recovery feedback loops.

5 / 5

Progressive Disclosure

A well-sectioned single file with clear headers, no nested references, and detail appropriately delegated to sub-agent definitions. It falls short of the 5 anchor because the sub-auditor category catalogs ('11 categorías DDD/tenant/migrations/etc', '13 gates /test-backend') are only gestured at without pointing to where they are defined, and the 'Self-fix policy detallada' section is placed after Step 5 rather than near the Step 3 case it governs — minor organization gaps matching the 4 anchor.

4 / 5

Total

18

/

20

Passed

Description

92%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 highly specific, complete description that clearly states what the auditor does and when it activates, with concrete trigger phrases and a distinct niche separate from dev-side skills. The only weakness is trigger keyword coverage, which could add a few natural synonyms and language variants.

Suggestions

Add one or two natural trigger synonyms (e.g. 'revisar', 'auditoría', 'audit', 'review ticket') alongside the existing '/auditor', 'auditá T-N', 'revisá ticket', 'verdict' triggers.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the full workflow: reads T-{n}-result.md, runs tests itself ('corre tests él mismo'), spawns auditor-{be,fe,agentic} sub-agents by surface, issues a three-valued verdict (APPROVED | CHANGES_REQUESTED | ESCALATED), applies self-fix with a 2-iteration cap, and writes REVIEW-final.md. Coverage is comprehensive rather than leaving minor gaps, so it matches the 5 anchor, not the 4.

5 / 5

Completeness

Both questions are explicitly answered: a clear 'what' (independent audit, running tests itself, spawning sub-auditors by surface, verdict types, self-fix cap, REVIEW-final.md output) and an explicit 'when' with concrete trigger phrases ('Activa cuando user dice...'). This matches the 5 anchor; the 4 anchor requires a weaker or less explicit 'when', which does not apply here.

5 / 5

Trigger Term Quality

'Activa cuando user dice: "/auditor", "auditá T-N", "revisá ticket", "verdict"' gives good natural trigger phrases including the slash command and imperative verb forms. Missing common synonyms and variations (e.g. 'revisar', 'auditoría', 'audit', 'review ticket'), so it fits the 4 anchor rather than comprehensive 5 coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche as an independent ticket auditor with distinct artifact-specific triggers (T-{n}-result.md, '/auditor', 'auditá T-N') and explicit separation from dev-side work ('NO se fía del dev'). Minimal overlap risk with other skills, matching the 5 anchor.

5 / 5

Total

19

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

alpacapurpura/ap_sales_agent

Path

.claude/skills/auditor/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.