CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agentteams-migrate

Analyze current OpenClaw setup and generate a migration package (ZIP) for importing into AgentTeams as a managed Worker

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./migrate/skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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, actionable migration workflow with concrete commands, templates, and an explicit final verification step. The main improvement areas are the ambiguous dual-path instruction in Step 5, the absence of a fix-and-re-verify loop after ZIP review, and inlining templates that would be better split into reference files.

Suggestions

Resolve Step 5's ambiguity by stating a single recommended order (update AGENTS.md/SOUL.md first, then run generate-zip.sh) and demoting the alternative to a short troubleshooting note.

Add a fix-and-re-verify loop to Step 6: after editing the Dockerfile or config in the ZIP, re-run the verification checklist before delivering the path.

Move the AGENTS.md and SOUL.md output templates into a references/ file (e.g., references/templates.md) and link to them from Steps 2 and 3 to slim the SKILL.md body and enable progressive disclosure.

DimensionReasoningScore

Conciseness

The body is efficient: the AgentTeams architecture, marker system, and environment mapping are product-specific facts Claude cannot be assumed to know, and commands are given without library tutorials or padded explanation. Only minor instances of over-explanation could be trimmed (e.g., "This is the most important step and requires your intelligence — it cannot be done mechanically"), keeping it below the lean-everywhere anchor of 5 but well above the some-unnecessary-explanation anchor of 3.

4 / 5

Actionability

Guidance is mostly executable end-to-end: concrete bash invocations with flags and defaults (analyze.sh, generate-zip.sh), complete markdown templates for the migrated AGENTS.md and SOUL.md, and exact verification commands (unzip -l). Minor gaps — the <SKILL_DIR> and <suggested-worker-name> placeholders and the heuristic judgment calls in Step 2 — keep it from the fully copy-paste-ready anchor of 5, but it clearly exceeds the incomplete-guidance anchor of 3.

4 / 5

Workflow Clarity

Six clearly sequenced steps with an explicit Step 6 verification checklist (manifest.json, Dockerfile, config contents) and concrete verify commands, plus a review-and-adjust loop in Step 1. Minor gaps keep it below 5: Step 5 offers two alternative paths ("update them first... Alternatively, run the script first, then manually replace") which is mildly ambiguous, and there is no fix-and-re-verify loop after editing the generated ZIP.

4 / 5

Progressive Disclosure

Good structure with clear sections, a Script Reference that points to real bundle files (scripts/analyze.sh and scripts/generate-zip.sh both exist), and one-level-deep navigation. It is below the well-split anchor of 5 because the ~230-line body inlines sizable templates (AGENTS.md/SOUL.md structures, builtin-merge example) that could live in references/, and templates/Dockerfile.tmpl in the bundle is never surfaced to the reader; above 3 because everything present is well-signaled and navigable.

4 / 5

Total

16

/

20

Passed

Description

70%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 specific and distinctive description that clearly states what the skill does and produces, but it lacks any "Use when..." trigger clause, which caps completeness at 3 and weakens its discoverability. Adding an explicit trigger phrase with a few natural synonyms would move it to the top band.

Suggestions

Append an explicit trigger clause, e.g., "Use when the user wants to migrate, move, or transfer an OpenClaw instance/agent into AgentTeams as a managed Worker."

Add natural synonyms ("move", "transfer", "port") alongside "migration" so the description matches varied user phrasing.

Optionally mention the produced artifacts (adapted AGENTS.md/SOUL.md, Dockerfile, import ZIP) to round out the "what" toward full coverage.

DimensionReasoningScore

Specificity

The description names several concrete actions — "Analyze current OpenClaw setup", "generate a migration package (ZIP)", "importing into AgentTeams as a managed Worker" — with only minor gaps in coverage (e.g., the config/file adaptation steps are not mentioned). It is not a 5 because coverage is not comprehensive, and not a 3 because more than 1-2 specific actions are listed with a concrete output artifact.

4 / 5

Completeness

The "what" is clear and concrete, but there is no "Use when..." clause or any equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is above 2 because the "what" is specific rather than vague; below 4 because the "when" is entirely absent rather than weakly stated.

3 / 5

Trigger Term Quality

Natural keywords like "OpenClaw", "AgentTeams", "migration", "Worker", and "ZIP" are exactly what a user needing this skill would say. A few natural variations are missing ("move", "transfer", "port" to AgentTeams), which keeps it below the comprehensive-synonym anchor of 5, but coverage is clearly better than the missing-variations anchor of 3.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — migrating an OpenClaw instance into AgentTeams — with unambiguous product-name triggers, making it highly distinguishable from other skills with minimal risk of triggering for the wrong one.

5 / 5

Total

16

/

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

agentscope-ai/AgentTeams

Path

migrate/skill/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.