CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

archify-tuning

Improve Archify diagram accuracy, visual quality and complete authoring speed with fewer repairs. Use for generation experiments or evaluating changes to layout, routing, diagnostics, authoring instructions and acceptance rules against actual diagrams and agent traces.

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

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.

A well-structured, information-dense process skill: the loop is explicitly sequenced with validation and stop conditions, and bundle files are used appropriately. The main improvement areas are tightening a few over-compressed sentences, making journal/recording formats concrete, and promoting the parenthetical trace-export reference to a clearly signaled link.

DimensionReasoningScore

Conciseness

The body is dense with project-specific policy and contains no padding or explanations of concepts Claude already knows, but a few over-packed sentences ('Keep synthetic regressions separate from the frozen first-draft denominator; additions to the corpus form a versioned cohort') and inline version-sensitive details ('Node 22.13 or later') could be tightened.

4 / 5

Actionability

The tools table gives copy-paste-ready commands and setup names concrete values ('$ARCHIFY_TUNING_HOME', 'ARCHIFY_CHROME'), but several loop steps stay at policy level (e.g. what a journal entry should contain is never specified), leaving minor gaps for an instruction-only skill.

4 / 5

Workflow Clarity

The six-step Loop is clearly sequenced with explicit validation ('Investigate each changed pass/fail result... Unexplained failures remain open'), feedback loops (repairs, re-verification, 'When to stop an experiment'), and preservation rules for failed attempts and the last verified artifact.

5 / 5

Progressive Disclosure

Three real, one-level-deep references (experiment-design.md, trace-signals.md, trace-export.md) are each signaled with their purpose, and the scripts/ folder is surfaced via a command table; minor gaps remain, such as trace-export.md being referenced only parenthetically and the ../../../CONTRIBUTING.md link pointing outside the bundle.

4 / 5

Total

17

/

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 with a clear what, an explicit 'Use for...' trigger clause, and a distinct product-anchored niche. Its only weaknesses are goal-level verbs instead of concrete action verbs and slightly thin synonym coverage in trigger terms.

DimensionReasoningScore

Specificity

Enumerates several concrete capability surfaces ('layout, routing, diagnostics, authoring instructions and acceptance rules', 'accuracy, visual quality and complete authoring speed with fewer repairs'), but the verbs are goal-level ('improve', 'evaluating') rather than distinct concrete actions, leaving minor gaps versus comprehensive coverage.

4 / 5

Completeness

Clearly answers both: the 'what' ('Improve Archify diagram accuracy, visual quality and complete authoring speed with fewer repairs') and an explicit, enumerated 'when' ('Use for generation experiments or evaluating changes to layout, routing, diagnostics, authoring instructions and acceptance rules against actual diagrams and agent traces').

5 / 5

Trigger Term Quality

Natural domain terms are present ('Archify', 'diagram', 'layout', 'routing', 'agent traces', 'generation experiments') and anchored by the product name, but common variations and synonyms (e.g. 'diagram quality', 'tuning', 'benchmarking') are missing.

4 / 5

Distinctiveness Conflict Risk

The named product 'Archify' plus the specific scope (diagram generation tuning, acceptance rules, agent traces) creates a clear niche with distinct triggers and minimal conflict risk with generic skills.

5 / 5

Total

18

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 2 suspicious

Warning

Total

13

/

16

Passed

Repository

tt-a1i/archify

Path

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