CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

crew-creator

Manage and optimize custom crew definition files (IDENTITY.md, AGENTS.md, SOUL.md, TOOLS.md). Also handles first-time employee initialization when .magic/ has no IDENTITY.md, including guiding setup and generating the crew definition. Use when users want to edit crew identity, modify workflow instructions, adjust personality, add/remove tools, optimize prompts, or initialize a new employee from scratch. Trigger signals: 'modify prompt', 'change identity', 'add tool', 'remove tool', 'optimize workflow', 'adjust personality', 'initialize employee', 'create employee'. Do NOT use for: skill creation (use skill-creator), skill searching (use find_skills tool).

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

85%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 content is highly actionable and workflow-safe: executable commands verified against real scripts, a hard validation gate with error-recovery loops, and clean one-level-deep progressive disclosure. Its main weakness is token efficiency — several procedures (skill-creator delegation, logo generation, language rules) are repeated verbatim across sections and could be consolidated.

Suggestions

State the skill-creator delegation once (e.g., in the Round 4 decision step) and reference it from the completion gate and After-Initialization steps instead of repeating the full instruction three times.

Fold the completion-gate logo step into a single reference to the Employee Logo Generation section rather than re-specifying the prompt components, save path, and icon update in both places.

Merge the three separate no-translation/single-language reminders (Language Generation Strategy, Round 1, and Generating Files) into one rule in the language section.

DimensionReasoningScore

Conciseness

The body is operational and free of concept explanations Claude already knows, but whole instructions repeat systematically: the skill-creator delegation appears three times (Round 4 step 8, the paragraph after the completion gate, and After-Initialization step 4), logo generation is fully specified twice (the Logo Generation section and completion-gate step 1), and the no-translations rule is stated three times. This is more than the minor trimming of anchor 4, but not the padded known-concept explanation of anchor 2.

3 / 5

Actionability

Guidance is fully executable: copy-paste shell_exec commands for init_crew.py (--config), check_crew.py, and all three tools.py subcommands (verified against the actual scripts), a concrete JSON config payload example, and specific parameters and thresholds (size="1024x1024", 500KB logo limit, icon: field). Covers the common init, edit, verification, and tool-query cases.

5 / 5

Workflow Clarity

Multi-step flows are clearly sequenced with explicit validation ("Verify that check_crew.py returns \"ok\": true. If any error is returned, fix the issues immediately before proceeding"), feedback loops ("revise the workflow content and validate it again", re-ask when the user is unsure in Round 4), a hard completion gate, and a rendered verification checklist — matching the anchor-5 pattern of explicit validation, error recovery, and checklists.

5 / 5

Progressive Disclosure

The body keeps workflows inline while splitting detailed specs into four real, one-level-deep reference files (crew-file-format.md, prompt-engineering-guide.md, avatar-generation-guide.md, available-tools.md — all verified to exist), each signaled at its point of use and summarized in the Reference Documents section; no reference points through to another reference, so navigation is easy and depth is one level.

5 / 5

Total

18

/

20

Passed

Description

96%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: it states concrete capabilities, names the four managed files, provides an explicit use-when clause with eight natural trigger phrases, and includes negative boundary guidance against the two most confusable skills. The only weakness is a couple of generic trigger terms ('modify prompt', 'optimize workflow') that carry some overlap risk with unrelated skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions covering all of the skill's functions — "Manage and optimize custom crew definition files (IDENTITY.md, AGENTS.md, SOUL.md, TOOLS.md)", "edit crew identity, modify workflow instructions, adjust personality, add/remove tools, optimize prompts, or initialize a new employee from scratch" — with no coverage gaps relative to the skill body, matching the comprehensive anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

Explicitly answers both what ("Manage and optimize custom crew definition files... Also handles first-time employee initialization when .magic/ has no IDENTITY.md") and when ("Use when users want to edit crew identity, modify workflow instructions, adjust personality, add/remove tools, optimize prompts, or initialize a new employee from scratch") with concrete trigger phrases, exactly matching the anchor-5 example pattern; not 4 because the 'when' clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Eight explicit natural trigger phrases ('modify prompt', 'change identity', 'add tool', 'remove tool', 'optimize workflow', 'adjust personality', 'initialize employee', 'create employee') plus concrete file names, with synonyms for initialization (initialize/create employee); no common variation is conspicuously missing, so it fits the comprehensive anchor rather than the few-missing anchor at 4.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (crew definition files under .magic/) with explicit exclusions for the closest neighbors ("Do NOT use for: skill creation (use skill-creator), skill searching (use find_skills tool)"), but trigger signals like 'modify prompt' and 'optimize workflow' are generic enough to fire for unrelated prompt- or workflow-related requests, giving minor overlap risk with closely related skills rather than the minimal risk of anchor 5.

4 / 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

dtyq/magic

Path

backend/super-magic/agents/skills/crew-creator/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.