CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bilan

Measure whether this session actually finished — the 0-10 completion number, computed from git, the carnet ledger, LIMITATION markers and CI instead of narrated. Use before reporting a completion number, when asked "where are we", at the end of a piece of work, and to find what a session that died left behind.

63

Quality

79%

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/bilan/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 highly actionable, with concrete commands, deterministic scoring rules, and well-validated edge-case handling, and its section structure is clear. Its weaknesses are density and monolithic structure: substantial design-rationale prose inflates the token budget, and ~310 lines of reference-grade detail live inline with no bundle files to offload them.

Suggestions

Move the stable reference material — 'This repo's shape', the sweep session-forensics in 'The three call sites', and the worktree/submodule mechanics — into a references/ file (e.g. references/repo-shape.md), keeping SKILL.md to the invocation rules, the caps table, and the core workflow.

Compress the design-history justification sections ('It used to be narrated…', the Stop-gate disarm rationale, 'Why not attribute automatically?') into one-line rationale notes attached to the rules they justify, cutting roughly a third of the body.

Give each cap in the 'What caps the score' table its remedy as an explicit command (e.g. the exact push and stash-apply forms already stated in prose), so remediation is copy-paste ready rather than described.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows and is information-dense, but several sections are design-history justification rather than operational guidance: "It used to be narrated", "Why not attribute automatically? It was tried and it does not work", the Stop-gate disarm rationale, and the dravr-platform/mirroir-mcp sweep comparison. These could be cut or heavily compressed without affecting execution, fitting the 3 anchor (mostly efficient, some unnecessary explanation that could be tightened) rather than 4 (only minor trims needed).

3 / 5

Actionability

Concrete, executable commands appear throughout: the four bilan.sh invocations with flags, defined exit codes, `bilan.sh ack --why "..."`, `git push origin <branch>:main`, `git submodule update --init .registre`, and `carnet.sh status <n>`, plus the precise core rule "Run it before you give a number. Report the score it prints." Minor gaps keep it below 5: most caps' remedies are described in prose rather than given as commands, and the limitation-label procedure names subcommands without a full invocation.

4 / 5

Workflow Clarity

The core loop — run the script, report the number it prints, apply each cap's printed evidence and remedy, re-run — is unambiguous and deterministic (exit codes, the min() rule), and the limitation exemption has an explicit two-half validation. It sits below 5 because the sequence is implicit across prose sections rather than a stated workflow, and the sweep/worktree subsections describe conditions and edge cases rather than ordered steps.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), and all deep reference material — repo shape, sweep session-forensics, worktree/submodule mechanics, CI policy — is inline in one ~310-line file. Section headers are clear, so it is above the 2 anchor's minimal structure, but content that belongs in separate reference files is inlined and there are no one-level-deep references at all, matching the 3 anchor.

3 / 5

Total

14

/

20

Passed

Description

87%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 strong description: it states what the skill computes and from which evidence sources in third person, and gives an explicit multi-trigger 'Use when' clause with genuinely natural phrases. The only shortfalls are a few missing synonym triggers and un-enumerated concrete checks.

DimensionReasoningScore

Specificity

"Measure whether this session actually finished — the 0-10 completion number, computed from git, the carnet ledger, LIMITATION markers and CI instead of narrated" plus "find what a session that died left behind" lists several concrete capabilities with their evidence sources. It falls short of the 5 anchor only because it does not enumerate the concrete checks (unpushed commits, todos, background tasks) that the body shows; it clearly exceeds the 1-2-action coverage of the 3 anchor.

4 / 5

Completeness

Both halves are explicit: the what ("the 0-10 completion number, computed from git, the carnet ledger, LIMITATION markers and CI instead of narrated") and the when with concrete trigger phrases ("Use before reporting a completion number, when asked 'where are we', at the end of a piece of work, and to find what a session that died left behind"). This matches the 5 anchor — the 'when' clause is explicit and multi-trigger, not the merely-present 'when' of the 4 anchor.

5 / 5

Trigger Term Quality

Natural user phrases are present: "reporting a completion number", "where are we", "at the end of a piece of work", "find what a session that died left behind". A few natural variations users would say are missing ("are we done", "did it finish", "wrap up"), which fits the 4 anchor (good coverage, a few terms missing) rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

The niche is highly specific — session-completion scoring keyed to named internal systems ("carnet ledger", "LIMITATION markers") and a "0-10 completion number" — and every trigger is anchored to that number, so it is unlikely to fire for unrelated skills. Clear niche with distinct triggers, minimal conflict risk.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

Atmosphere/atmosphere

Path

.agents/skills/bilan/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.