CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

diagram-cli

Generate, validate, and refresh @brainwav/diagram architecture artifacts when repo diagrams, context packs, PR impact, or CI drift evidence is needed.

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 ./Skills/agent-ops/diagram-cli/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 well-organized, efficient runbook body with clear sequencing, explicit validation gates, and mostly well-signaled bundle references. Its weakest point is actionability: the skill directs the agent to run deterministic commands but never names or exemplifies a single one, leaving execution details unresolved within the skill and its referenced contract.

Suggestions

Add the actual diagram/context-pack command names and at least one complete invocation example (e.g., a copy-paste command line with repo path, goal, and output-root arguments) to the Workflow or Examples section.

Either verify and correct the "Infrastructure/references/deferred-skill-context/agent-ops-diagram-cli/" path so it resolves in the bundle, or remove it in favor of the existing references/ files.

Trim the Philosophy section, whose bullets (e.g., "Start from live evidence and local patterns") largely restate Workflow and Avoid, to reduce token cost without losing guidance.

DimensionReasoningScore

Conciseness

The body is compact bullet lists with no explanations of concepts Claude already knows — every section is short and directive. Not 5 because the Philosophy bullets ("Produce reproducible architecture artifacts before making architecture claims", "Start from live evidence and local patterns") and parts of Anti-Patterns largely duplicate Workflow/Avoid and could be trimmed; not 3 since there is no padded or unnecessary conceptual explanation.

4 / 5

Actionability

"Run deterministic diagram/context-pack commands" gives no command names, syntax, or invocation examples anywhere in the body — the core executable detail is missing, and the Examples section lists user prompts ("Refresh the architecture context pack for this repo") rather than runnable commands. There is concrete guidance ("Report exact failed command and artifact path", "Stop on the first broken artifact gate") and a pointer to references/contract.yaml, but that contract also contains no commands, so guidance remains incomplete rather than minimal — matching the 'some concrete guidance but missing key details' anchor, not the 2 anchor's high-level-hints-only level.

3 / 5

Workflow Clarity

The Workflow section gives a clear ordered sequence with an explicit validation checkpoint ("Validate manifest completeness and placeholder status") and a fail-fast feedback loop ("Stop on the first broken artifact gate"; "stop at first failed gate; do not proceed until it is fixed and rerun"), so batch operations are gated. Not 5 because the steps stay abstract — no concrete commands, and the validation mechanics are delegated elsewhere; comfortably above 3 since checkpoints and error-recovery loops are explicit rather than implicit.

4 / 5

Progressive Disclosure

The Progressive Disclosure section clearly signals one-level-deep references, and references/contract.yaml, references/evals.yaml, and references/task-profile.json all exist in the bundle. Not 5 because "Infrastructure/references/deferred-skill-context/agent-ops-diagram-cli/" does not exist in the bundle — a dangling navigation path; not 3 since structure and signaling are otherwise genuinely good with the body appropriately kept lean.

4 / 5

Total

15

/

20

Passed

Description

83%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 tight, third-person description that clearly pairs three concrete capabilities with an explicit when-trigger clause naming concrete scenarios. Its main weaknesses are jargon-heavy triggers and missing natural synonyms, which slightly limit keyword coverage and leave minor conflict risk with generic diagramming requests.

DimensionReasoningScore

Specificity

Lists three concrete actions — "Generate, validate, and refresh" — against a named tool/domain ("@brainwav/diagram architecture artifacts"), with artifact types ("repo diagrams, context packs") surfacing in the trigger clause. Falls short of 5 because coverage of what is actually produced is thinner than the comprehensive multi-action anchor; above 3 because it exceeds the 1-2-action anchor.

4 / 5

Completeness

Explicitly answers both questions: the 'what' is "Generate, validate, and refresh @brainwav/diagram architecture artifacts" and the 'when' is the explicit clause "when repo diagrams, context packs, PR impact, or CI drift evidence is needed" with concrete triggers. This matches the anchor for a clear 'what' plus explicit 'when' with concrete trigger phrases, so it does not cap at 3 or sit at 4.

5 / 5

Trigger Term Quality

"repo diagrams", "context packs", "PR impact" are terms users would plausibly say, giving good keyword coverage. Not 5 because "CI drift evidence" and "@brainwav/diagram" are tool-specific jargon and natural synonyms like "architecture map" or "onboarding diagram" are absent; not 3 since several genuinely natural trigger phrases are present, not just generic keywords.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — architecture evidence artifacts tied to a specific @brainwav/diagram toolchain with triggers like "context packs" and "CI drift evidence". Minor overlap risk remains because "repo diagrams ... needed" could catch generic diagram-drawing requests; not 5 for that residual overlap, not 3 because the tool anchoring keeps it well above the merely-somewhat-specific anchor.

4 / 5

Total

17

/

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

jscraik/Agent-Skills

Path

Skills/agent-ops/diagram-cli/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.