CtrlK
BlogDocsLog inGet started
Tessl Logo

conformance-sweep

Scheduled sweep that checks a repository against its team standards and reports one Tessl finding per standard it drifts from, for the `remediate` action to fix. Use as the skill of the weekly conformance-sweep schedule.

68

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

92%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 tight, well-sequenced operational skill: concrete CLI commands, a complete finding payload template, explicit confirmation and deduplication checkpoints, and a clear do-nothing terminal state. The only minor gap is the unspecified shape of the update payload (changes.json) used when appending observations to an existing finding.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: every line instructs ('Skip generated code (`genproto/`, `pb/`) ... and agent context (`.claude/`, `.agents/`, `.tessl/`)', 'Leave out `loopId` and `runId`; the service derives them from the scheduled run'). No padding and no explanation of concepts Claude already knows, matching the 'every token earns its place' anchor.

5 / 5

Actionability

Concrete, executable commands are given ('tessl finding list --project $TESSL_PROJECT_ID --limit 100 --json', 'tessl finding create --project $TESSL_PROJECT_ID --file finding.json --json') plus a complete finding.json template. Not a 5 because the update path references '--file changes.json' without showing that payload's shape, a minor gap in otherwise copy-paste-ready guidance.

4 / 5

Workflow Clarity

The six-step procedure is clearly sequenced with explicit validation checkpoints for a batch operation: 'A violation is confirmed when you can quote the rule and point to the line', 'view likely matches before deciding', and a terminal check ('If nothing drifts, create nothing'). Validation is present, so the missing-validation cap does not apply, and the sequence matches the explicit-checkpoint anchor.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no external references needed; the content is split into well-organized sections (header rule, Inputs, Procedure, payload template, Finish). Per the simple-skill guideline, this earns a 5 — all references inside the body (rules/*-standards.md, AGENTS.md/CLAUDE.md chain) are inputs to read at runtime, not skill bundle files, and no bundle directories exist.

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.

The description is written in third person, states concrete capabilities, and includes an explicit 'Use as...' trigger clause tied to the weekly schedule. Its weaknesses are limited keyword variation (missing synonyms like 'compliance' or 'coding standards') and a single, narrow trigger condition.

Suggestions

Broaden trigger-term coverage with natural synonyms, e.g. 'Use for the weekly conformance-sweep schedule, or when asked to check the repository against team/coding standards or compliance rules.'

If the skill can also be invoked on demand (not only via the weekly schedule), state that as an additional explicit trigger condition to strengthen completeness.

DimensionReasoningScore

Specificity

Quotes concrete actions — 'checks a repository against its team standards and reports one Tessl finding per standard it drifts from, for the `remediate` action to fix' — naming the domain and several specific operations. Not a 5 because it stops short of the fuller action coverage (e.g., reading standards, deduplicating existing findings) that would make it comprehensive, and not a 3 because it goes beyond the 1-2 generic actions anchor.

4 / 5

Completeness

Both parts are explicit: the 'what' ('checks a repository against its team standards and reports one Tessl finding per standard it drifts from') and the 'when' ('Use as the skill of the weekly conformance-sweep schedule'). Not a 5 because the 'when' is a single narrow schedule-wiring trigger rather than a set of concrete trigger phrases, and not a 3 because the trigger guidance is explicit, not merely implied.

4 / 5

Trigger Term Quality

Relevant keywords are present ('conformance', 'team standards', 'drift', 'Tessl finding', 'weekly ... schedule') but common variations and synonyms users might naturally say ('coding standards', 'compliance', 'lint', 'standards check') are missing. It fits the 'some relevant keywords but missing common variations' anchor rather than the good-coverage anchor at 4.

3 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche anchored by distinct triggers — 'Tessl finding', 'remediate', 'weekly conformance-sweep schedule' — so it is unlikely to fire for an unrelated skill. This matches the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
perihelionhq/perihelion-platform-context
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.