CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

quality-security-loop

Use when closing a Python coding task, choosing quality or security checks, or deciding whether the agent delivery loop still needs another pass on a data-platform change.

Quality

72%

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 ./.agents/skills/quality-security-loop/SKILL.md

The canonical home for this skill is quality-security-loop in fazedordecodigo/python-api-validation-discovery

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.

The body is a tight, highly actionable operating procedure: a concrete diff-to-check map, exact run commands, explicit validation gates, and well-defined stop conditions for the delivery loop. Progressive disclosure is handled well, with the only soft spots being external references that live outside the bundle and a minor organization nit on the extra-source pointer.

DimensionReasoningScore

Conciseness

The ~40-line body is dense and lean: every line is instruction (tool-to-diff mapping, run commands, stop rules) with zero explanation of concepts Claude already knows. It matches anchor 5 ('lean and efficient; every token earns its place') — nothing to trim without losing guidance.

5 / 5

Actionability

Concrete commands are given ('Rode `python3 scripts/agent_loop.py` (ou `apm run loop`, ou o prompt `run-agent-loop`)'), the tool selection map is fully specific (Python → Ruff/mypy/Bandit, any change → gitleaks, dependency file → pip-audit, Dockerfile/Terraform/CloudFormation → Trivy), and failure handling names concrete artifacts (`propriedade_quebrada`, `contraexemplo_minimo`). Minor gaps keep it at anchor 4 rather than 5: the mechanics of the loop and feedback format are deferred to `loop.yaml` and docs the reader must open, and no inline example shows a check invocation or failure output.

4 / 5

Workflow Clarity

The 8-step sequence has explicit validation checkpoints ('Só feche quando o que falhava passa e o que já passava continua passando'), feedback loops with error recovery (fix `propriedade_quebrada`/`contraexemplo_minimo` on failure), and hard stop conditions (repeated failure hash → discard the patch; cap of 3 iterations; missing tool is a failure). This matches anchor 5 (clear sequence, explicit validation, feedback loops for error recovery).

5 / 5

Progressive Disclosure

Structure is good: three clear sections, details correctly deferred one level deep to well-signaled sources ('Fonte da verdade (não copie o texto dessas páginas; abra e siga)': `docs/qualidade-seguranca.md`, `docs/agent-delivery-loop.md`), with the operational check map inlined where it belongs. It falls short of anchor 5 because the referenced files (`loop.yaml`, `scripts/*.sh`, docs) are not part of the skill bundle, and 'Fonte extra: `docs/papers-research.md`' is tacked onto the end of the step list rather than placed with the other sources.

4 / 5

Total

18

/

20

Passed

Description

43%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 is concise and provides explicit, natural 'Use when...' triggers, but it is purely trigger-based: it never states what the skill does, so a reader cannot tell from the description alone whether it runs checks, selects tools, or manages the delivery loop. Distinctiveness is moderate due to overlap with generic quality/security review wording.

Suggestions

Prepend a capability statement naming the concrete actions, e.g. 'Runs Ruff, mypy, Bandit, gitleaks, pip-audit, and Trivy on the diff and drives the agent delivery loop (max 3 passes). Use when...'

Add natural keyword variations users would say — 'lint', 'run the checks', 'tests', 'audit' — so the description triggers on those phrasings.

Tie the quality/security framing to the delivery loop more explicitly (e.g. 'deciding whether the loop needs another pass after checks fail') to reduce overlap with generic code-review skills.

DimensionReasoningScore

Specificity

The description names its domain ("closing a Python coding task", "quality or security checks", "agent delivery loop", "data-platform change") but states no concrete skill capabilities — it never says what the skill actually does (e.g., which checks it runs or how it drives the loop). This matches anchor 2 ('names the domain but actions are minimal or generic'); it is not 3 because no concrete skill action is listed, and not 1 because the domain is clearly identified.

2 / 5

Completeness

The description is entirely a 'when' clause ("Use when closing... choosing... or deciding...") with no statement of what the skill does — the capability side is absent, not merely weakly implied. This matches anchor 2 ('only when is present without what'); it cannot be 3 because the 'what' is the missing half, not the 'when'.

2 / 5

Trigger Term Quality

Natural trigger phrases users would plausibly say are present: "closing a Python coding task", "quality or security checks", "another pass". It misses common variations such as "lint", "run the checks/tests", "code review", or "audit", so it fits anchor 4 (good keyword coverage, a few natural terms missing) rather than 5.

4 / 5

Distinctiveness Conflict Risk

Phrases like "quality or security checks" on a "Python coding task" overlap broadly with generic code-review, lint, and security-review skills, though the "agent delivery loop" and "data-platform" framing narrows it. This is anchor 3 (somewhat specific but could still overlap with similar skills) — not 4, since the overlap risk with closely related check/review skills is more than minor.

3 / 5

Total

11

/

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

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

15

/

16

Passed

Repository

fazedordecodigo/python-api-validation-discovery

Path

.agents/skills/quality-security-loop/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.