CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

migrate-area

Port one story of the AM console migration to React (epic AM-7349) from the Angular console to gravitee-am-console, with the Gamma prototype page as the UI, the Angular code as the behaviour, and one pull request to master at the end. Use when the user runs /migrate-area <story key>, says "port AM-XXXX", "migrate <area> to React", or asks to continue the AM console migration. The story keys are in references/stories.json.

Quality

100%

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

100%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 a tightly written, fully executable 10-step procedure with per-step validation gates, explicit stop conditions, and well-signaled one-level-deep references into the three bundle files. It assumes Claude's competence throughout, spending tokens only on non-obvious project conventions, pitfalls, and checks. This is about as strong as a workflow skill body gets.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and never explains concepts Claude already knows; even the embedded rationale (e.g. "Graphene `CopyableText` renders a `<button>` with no `type`, so a click submits the form that holds it", "A 504 on `/gamma/organizations/DEFAULT/modules` means that `:8083` is down") is non-obvious project-specific knowledge that earns its tokens. Every sentence instructs, matching the 'lean and efficient; assumes Claude's competence' anchor rather than the minor-trimmings anchor at 4.

5 / 5

Actionability

Concrete, executable guidance throughout: copy-paste `jq`, `git`, `yarn`, `curl`, and `npx playwright test --project=console-next <spec>` commands; exact file paths and naming conventions ("`feat(console): <story summary>` and the footer `fixes <key>`"); and a concrete per-page test matrix. This matches 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'; a 4 would have minor gaps in executability, which are absent.

5 / 5

Workflow Clarity

Steps 0–9 are explicitly ordered ("You follow the steps below in order"), each with 'Stop if' conditions and a 'Check:' gate (typecheck after the API module and pages, route-resolution check, the Step 8 verify with build plus browser comparison against the Angular console, and re-running the four checks after a rebase). Destructive actions are gated ("Ask the user before the commit... before the push and the pull request"), and the part-way-resume and stop-and-report rules give explicit error-recovery loops — the anchor-5 pattern of explicit validation with feedback loops, not merely 'most checkpoints' at 4.

5 / 5

Progressive Disclosure

The Inputs table clearly signals each one-level-deep bundle file and what it holds (stories.json, units.json, conversion-rules.md — all verified to exist), and navigation is section-level ("Read sections 1 and 3 once per run", "Section 2 when an Angular page has behaviour the prototype left out"). The 35K conversion-rules detail is correctly externalized while the procedure itself stays in SKILL.md, matching 'clear overview with well-signaled one-level-deep references; content appropriately split' rather than the minor-organization-gaps anchor at 4.

5 / 5

Total

20

/

20

Passed

Description

100%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 exemplary: third-person, concrete, free of fluff, and it states both the full scope of the operation and an explicit, enumerated set of natural trigger phrases including the slash command. It is tightly scoped to a single migration epic, which makes conflicts with other skills very unlikely. No changes needed.

DimensionReasoningScore

Specificity

"Port one story of the AM console migration to React (epic AM-7349) from the Angular console to gravitee-am-console, with the Gamma prototype page as the UI, the Angular code as the behaviour, and one pull request to master" names the source, target, method, and deliverable with no vague language. This matches the anchor for multiple specific concrete actions with comprehensive coverage; a 4 would require minor gaps in what the skill does, but every component of the operation is explicit.

5 / 5

Completeness

It explicitly answers both questions: the 'what' (port one story, with the prototype as UI, Angular code as behaviour, one PR to master) and an explicit 'Use when...' clause with concrete trigger phrases. This is the anchor-5 pattern of a clear 'what' plus an explicit, enumerated 'when'; at 4 the 'when' would only be present but less specific.

5 / 5

Trigger Term Quality

The description enumerates exact natural triggers: "Use when the user runs /migrate-area <story key>, says 'port AM-XXXX', 'migrate <area> to React', or asks to continue the AM console migration" — covering the slash command, a story-key mention, an area-phrase, and a continuation request. Coverage including synonyms is comprehensive, so it fits the top anchor rather than the 'a few natural terms missing' anchor at 4.

5 / 5

Distinctiveness Conflict Risk

The description is anchored to a clear niche (epic AM-7349, the AM console migration, gravitee-am-console) with distinct trigger phrases, so it is unlikely to fire for an unrelated skill. It fits 'clear niche with distinct triggers; minimal conflict risk'; a 4 would imply meaningful overlap with closely related skills, which the project-specific anchoring rules out.

5 / 5

Total

20

/

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

gravitee-io/gravitee-access-management

Path

docs/agent-standards/skills/migrate-area/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.