CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arn-code-assess

This skill should be used when the user says "arness code assess", "arn-code-assess", "tech debt audit", "assess the project", or wants a comprehensive technical assessment of the codebase against stored patterns followed by prioritized improvement execution through the full Arness pipeline.

Quality

83%

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

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

An exemplary orchestration skill body: fully actionable sequencing with explicit decision gates, validation checkpoints, resumability, and error-recovery loops, with heavy detail correctly pushed into two real reference files. The main cost is token efficiency — substantial boilerplate repetition inflates length without adding guidance value.

Suggestions

State the agent model-dispatch convention (`.arness/agent-models/code.md` plus the ensure-config fallback) once in an early 'Agent dispatch' note and reference it from Steps 3 and 11 instead of repeating the full parenthetical four times.

Replace the ten inline progress-display code blocks with one template plus a stage order list (scope → assess → ... → ship) and instruct per step: "Show progress with the current stage highlighted."

Consider moving the per-gate AskUserQuestion wording and options for G1-G7 into a decision-gates section of a reference file, keeping the compact gate table in the main body.

DimensionReasoningScore

Conciseness

The body is mostly efficient prose with no explanations of concepts Claude already knows, but it repeats the agent-dispatch parenthetical ("passing the model from `.arness/agent-models/code.md` as the `model` parameter... Dispatch convention for fallback") four times, inlines ten near-identical progress-display code blocks, and duplicates the pattern-file list in both Prerequisites and Step 0. It matches anchor 3 (could be tightened) rather than 2, since the padding is repetitive boilerplate rather than unnecessary explanation.

3 / 5

Actionability

Every step gives executable guidance: exact gate questions and options, exact invocations (`Skill: arn-code:arn-code-plan <spec-name>`, Agent tool with model parameter and fallback reference), artifact filename patterns (`ASSESSMENT_<scope-name>.md`, `spec_states` tracking), and explicit Read commands for the protocol references. Nothing is left as vague direction, matching anchor 5; anchor 4 would require missing key details, and there are none.

5 / 5

Workflow Clarity

The multi-step pipeline is explicitly sequenced (Steps 0-13) with seven named decision gates, a resumability artifact table, per-spec conflict detection before execution, and a test-verdict feedback loop ("Fix and re-test... Loop on option 1 until tests pass"). As a batch operation across multiple specs it has explicit validation checkpoints and error-recovery branches throughout, matching anchor 5.

5 / 5

Progressive Disclosure

Two real, one-level-deep references (`references/assessment-protocol.md`, `references/orchestration-flow.md`) are loaded at point of need with explicit Read commands, and detail-heavy material (agent prompt templates, merge/dedup procedures, ordering heuristic) is properly externalized. It falls short of anchor 5 because the body still retains inline detail that could be externalized — per-gate question scripts, the repeated dispatch convention, and the ten progress-display blocks — and it leans on a cross-skill reference for the dispatch fallback.

4 / 5

Total

17

/

20

Passed

Description

78%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 with explicit, natural trigger phrases and a clearly stated purpose. Its main weakness is that the capability description is abstract — it summarizes intent rather than enumerating what the skill concretely does.

Suggestions

Enumerate the concrete pipeline stages in the description, e.g. "Runs parallel assessment agents, lets the user prioritize findings, then drives each improvement through spec → plan → execute → test → ship."

Add one or two natural trigger variations users might say, such as "code audit" or "improvement assessment", to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain and a couple of actions — "a comprehensive technical assessment of the codebase against stored patterns followed by prioritized improvement execution" — but these remain abstract; it never lists concrete pipeline stages (spec → plan → execute → test → ship). It matches anchor 3 (domain plus 1-2 actions, not comprehensive) rather than 4, which requires several specific actions.

3 / 5

Completeness

"This skill should be used when the user says..." explicitly answers when with concrete quoted trigger phrases, and the what is explicitly stated (assessment against stored patterns plus prioritized improvement execution through the Arness pipeline). Both halves are explicit, matching anchor 5; anchor 4 would require the 'when' to be less explicit than these direct trigger statements.

5 / 5

Trigger Term Quality

Quoted triggers "arness code assess", "arn-code-assess", "tech debt audit", and "assess the project" are phrases a user would naturally say. Good coverage, but common variations like "code audit", "review the codebase", or "improvement assessment" are missing, so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The brand-specific triggers ("arness code assess", "arn-code-assess") create a clear niche with minimal conflict, but the generic phrase "assess the project" could overlap with other code-review or assessment skills. Mostly distinct with minor overlap risk fits anchor 4; not 5 because of that generic trigger.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

AppsVortex/arness

Path

plugins/arn-code/skills/arn-code-assess/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.