CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-lifecycle-promotion

Use when adding or auditing Agentlas skill lifecycle metadata, skill-registry.json, trial evidence, Curator promotion decisions, or first-class skill promotion gates.

Quality

80%

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/skill-lifecycle-promotion/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 lean, well-structured governance procedure with concrete file names, setting values, and explicit promotion-blocking checkpoints. Its only weakness is minor incompleteness in executable detail — registry entry structure and success-predicate format are invoked but never specified.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no explanation of concepts Claude already knows, and every line carries governance-specific instruction (e.g. "Curator decisions never authorize executable file changes by themselves"). The one-line intro is mildly redundant with the description but does not constitute padding.

5 / 5

Actionability

Mostly concrete, executable guidance: exact file paths (".agentlas/skill-registry.json", ".agentlas/skill-trials.jsonl") and exact setting values ("tier: candidate", "runtimeFirstClassRecallEnabled: false"). Minor gaps: no schema or example entry for the registry files, and "Add success predicates and situation tags for every skill" gives no format or location.

4 / 5

Workflow Clarity

A clear 9-step numbered sequence with explicit checkpoints — step 4 gates the recall flag on staged-diff acceptance and step 8 "Block promotion when authority separation, sealed holdouts, replayability, or rollback evidence is missing". Below level 5 because there is no explicit error-recovery feedback loop (what to do when a gate blocks promotion) and no instruction for how to verify evidence like replayability.

4 / 5

Progressive Disclosure

Under 50 lines with well-organized sections (Procedure, Output) and no external references needed; the simple-skill exception applies, so well-organized sections alone warrant full credit. No bundle files exist and none are required.

5 / 5

Total

18

/

20

Passed

Description

65%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 highly distinctive and domain-specific with good trigger terms, but it front-loads the 'when' clause and never states the skill's actual capability ('what') as an independent statement. Adding a third-person capability sentence before the "Use when" clause would materially raise both specificity and completeness.

Suggestions

Prepend a third-person capability statement, e.g. "Adds and audits Agentlas skill lifecycle metadata (skill-registry.json, trial evidence, Curator decisions) and enforces first-class promotion gates." before the "Use when..." clause so the 'what' is explicitly stated, not just implied by the gerund.

Add natural trigger variations users would plausibly say, such as "promote a skill", "skill trials", "skill registry", or "curator decisions", to broaden keyword coverage toward level 5.

Briefly indicate the skill's observable output (e.g. "returns registry status, evidence gaps, and rollback/quarantine status") so users can distinguish what this skill produces from related governance skills.

DimensionReasoningScore

Specificity

The only actions named are the generic verbs "adding or auditing" applied to a list of specific artifacts ("skill-registry.json, trial evidence, Curator promotion decisions"); no distinct capability statement of what the skill itself does. This matches the anchor for naming a domain with 1-2 concrete actions rather than the several specific actions of level 4.

3 / 5

Completeness

The explicit "Use when..." clause answers 'when' with concrete triggers, but the 'what' is never separately stated — the skill's own capability is only implied by the gerund "adding or auditing". Anchor 4 requires both a distinct 'what' and 'when'; anchor 2 requires a contentless 'when', so this sits between them.

3 / 5

Trigger Term Quality

Includes good natural domain keywords users would say: "skill lifecycle metadata", "skill-registry.json", "Curator promotion decisions", "first-class skill promotion gates". It falls short of level 5 because common variations like "promote a skill", "skill trials", or "skill registry" are absent.

4 / 5

Distinctiveness Conflict Risk

Highly niche triggers anchored to proprietary artifacts ("Agentlas", "skill-registry.json", "Curator promotion decisions") make triggering for the wrong skill extremely unlikely — a clear niche with distinct triggers.

5 / 5

Total

15

/

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

agentlas-ai/Agentlas-OS

Path

.agents/skills/skill-lifecycle-promotion/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.