ac-workspace-manager

Manage git worktrees for isolated development. Use when creating isolated workspaces, managing parallel development, handling worktree lifecycle, or merging completed work.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/ac-workspace-manager/SKILL.md

Quality

Content

68%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 concise, actionable skill body with good structure and a valid file reference, weakened mainly by missing validation checkpoints around the destructive merge/cleanup workflow.

Suggestions

Add explicit validation steps to the Workflow before Merge and Cleanup (e.g., verify the build/tests pass and confirm the merge target) to lift workflow_clarity above 3.

Remove the redundancy between the inline "## API" section and the "## API Reference" pointer, or clearly split quick examples from full reference.

Trim the Purpose section, which restates the frontmatter description, to improve token efficiency.

Dimension	Reasoning	Score
Conciseness	The body is lean with code, a diagram, and a short workflow list, but the Purpose line repeats the description and the inline "## API" section overlaps with the separate "## API Reference" pointer.	4 / 5
Actionability	Quick Start and API sections give concrete, executable Python calls (create_worktree, list_worktrees, merge_completed, cleanup_worktree) covering common cases, with only minor gaps like error-handling examples.	4 / 5
Workflow Clarity	The five steps (Create, Develop, Review, Merge, Cleanup) are sequenced, but the destructive merge and cleanup steps lack explicit validation checkpoints or feedback loops, capping the score at 3 per the destructive-operation rule.	3 / 5
Progressive Disclosure	Sections are well organized and the bulk of the API is one level deep via a real referenced file ("See scripts/workspace_manager.py for full implementation"), though the inline API section slightly duplicates that pointer.	4 / 5
	Total	15 / 20 Passed

Description

87%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 well-constructed description that answers both what and when with concrete, natural trigger phrases and a distinct niche. Minor room to sharpen the action verbs for full specificity.

Dimension	Reasoning	Score
Specificity	"Manage git worktrees" plus "creating isolated workspaces, managing parallel development, handling worktree lifecycle, or merging completed work" lists several concrete actions covering the domain, but verbs like "managing" and "handling" are slightly generic rather than fully comprehensive.	4 / 5
Completeness	It states the what ("Manage git worktrees for isolated development") and an explicit when ("Use when creating isolated workspaces, managing parallel development, handling worktree lifecycle, or merging completed work") with concrete trigger phrases.	5 / 5
Trigger Term Quality	Natural phrases users would say appear ("git worktrees", "isolated workspaces", "parallel development", "merging completed work"), giving good keyword coverage, though a few common synonyms are absent.	4 / 5
Distinctiveness Conflict Risk	Git worktrees are a clear, narrow niche with distinct triggers (isolated workspaces, worktree lifecycle, merging), making overlap with unrelated skills minimal.	5 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

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: fernandezbaptiste/Skrillz
Path: skills/ac-workspace-manager/SKILL.md
Commit: 93ed392

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.