CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

migrate-application-operation

Create or migrate a protected Sim resource operation in the shared Principal and application-use-case architecture across internal APIs, public or versioned APIs, Copilot, and other trusted tool adapters. Use when adding a protected endpoint, tool command, or CRUD method; removing route- or tool-local authorization and business logic; consolidating resource reads or writes behind semantic operation policies; or adding another surface to an existing application operation while preserving contracts, identity, errors, rate limits, audit, analytics, and compatibility behavior. Treat v1, uploads, streams, large bodies, bulk recursion, and polymorphic tools as explicitly scoped special cases.

Quality

92%

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

88%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 strong, dense, highly actionable process document: concrete file paths, executable commands, real TS patterns with explicit adaptation notes, explicit validation gates, and fail-fast checkpoints throughout. Its only weaknesses are mild repetition across the surface-adapter sections and a monolithic single-file structure where per-surface detail could live in reference files.

Suggestions

Split the per-surface adapter sections (internal APIs, public/versioned APIs, Copilot, other tools) into one-level-deep reference files (e.g., references/copilot.md), keeping SKILL.md as the overview plus the core invariants and workflow.

Trim repeated identity/authorization warnings across the 'Adapt Copilot' and 'Adapt other internal or external tools' sections by stating the shared rule once in 'Preserve identity and attribution' and referencing it.

Convert the ordered pipeline in 'Keep the layers distinct' and the legacy-order comparison into a single canonical lifecycle diagram/section to avoid restating the same order twice.

DimensionReasoningScore

Conciseness

The ~360-line body is dense and imperative with almost no explanation of concepts Claude already knows — every section encodes project-specific invariants, failure modes, and edge cases. Minor trimming is possible (e.g., identity/authorization warnings repeated across the surface-adapter sections), which keeps it just below the 'every token earns its place' anchor.

4 / 5

Actionability

Fully concrete: executable check commands ('bun run --cwd apps/sim test ...', 'bunx biome check', 'bunx turbo run type-check', 'bun run check:audits', 'git diff --check'), exact foundation file paths to read, and complete TS examples for defineWorkspaceOperation, defineAuthorizedWorkspaceUseCase, and the Copilot adapter. The illustrative nature of the code is explicitly justified ('Adapt the example to the domain's real authorization options; do not copy invented field names'), satisfying the rubric's flexibility exception.

5 / 5

Workflow Clarity

The phases are clearly sequenced (read foundation → bound the migration → freeze baseline → define operation → implement use case → adapt each surface → identity/attribution → special cases → test → parallel work → hand off) with explicit validation checkpoints: the 'test-audit' gate before writing tests, characterization tests gated on 'test-audit', fail-fast rules throughout, and a concrete verification command block with 'Do not claim a check passed unless it completed successfully'. This is a batch/behavior-preservation migration skill and the required feedback loops (inject failure after each committing step, re-check) are present.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so the body carries all content; it is well-sectioned with clear ## / ### headers and navigable ordered phases. Minor gap: per-surface adapter detail (e.g., the Copilot section, special cases) is inlined and could be split into one-level-deep reference files to keep SKILL.md leaner — 'good structure, minor organization gaps' rather than an ideal split.

4 / 5

Total

18

/

20

Passed

Description

92%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 comprehensive, concrete, and clearly niche-scoped, with an explicit 'Use when' clause covering multiple trigger scenarios and named exclusions. Its only weakness is trigger phrasing dominated by internal architecture jargon rather than the natural words a user would say.

DimensionReasoningScore

Specificity

Multiple concrete actions are listed: 'Create or migrate a protected Sim resource operation', 'adding a protected endpoint, tool command, or CRUD method', 'removing route- or tool-local authorization and business logic', 'consolidating resource reads or writes behind semantic operation policies', and 'adding another surface to an existing application operation'. Coverage is comprehensive and stays in third person.

5 / 5

Completeness

Explicitly answers 'what' ('Create or migrate a protected Sim resource operation...') and 'when' with a concrete 'Use when adding a protected endpoint, tool command, or CRUD method; removing route- or tool-local authorization...' clause, plus explicitly scoped special cases (v1, uploads, streams, large bodies, bulk recursion, polymorphic tools).

5 / 5

Trigger Term Quality

Good natural trigger phrases: 'adding a protected endpoint', 'tool command', 'CRUD method', 'Copilot'. However, much of the phrasing is dense internal jargon ('shared Principal and application-use-case architecture', 'semantic operation policies') that a user would not naturally say, and a few natural variations (e.g., 'add a route', 'wire up a tool') are absent — falls just below the comprehensive-with-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche: 'Sim resource operation', 'Principal', 'Copilot', 'v1', 'uploads, streams, large bodies, bulk recursion' are highly specific to this codebase's operation-migration task; minimal risk of triggering for a different skill.

5 / 5

Total

19

/

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

simstudioai/sim

Path

.agents/skills/migrate-application-operation/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.