CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orchestrate-batch-refactor

Plan and execute large refactors with dependency-aware work packets and parallel analysis.

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/orchestrate-batch-refactor/SKILL.md

The canonical home for this skill is orchestrate-batch-refactor in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 a well-structured, highly actionable orchestration guide with explicit validation checkpoints, feedback loops, and a clean two-file bundle properly linked one level deep. The only weakness is minor redundancy among the three scope/usage sections, which could be consolidated for token efficiency.

DimensionReasoningScore

Conciseness

The body is lean with no over-explanation of concepts Claude already knows, but the Overview, "When to Use", and "When to Use Parallelization" sections partially duplicate each other ("refactor spans many files or subsystems" vs. "medium/large scope touching many files or subsystems") and could be merged.

4 / 5

Actionability

Guidance is fully executable for an orchestration skill: exact questions to ask explorers ("intent map, coupling risks, candidate work packets, required validations"), a six-field packet contract, and copy-paste-ready prompt templates in references/agent-prompt-templates.md, which is a real file. Code absence is not penalized since this is an instruction-only skill with actionable guidance.

5 / 5

Workflow Clarity

The six-step Core Workflow is clearly sequenced with an ordered Validation Strategy (packet-level, cross-packet, full project), explicit feedback loops ("Stop and re-plan when packet boundaries cause repeated merge conflicts"), and gate conditions ("Do not claim completion if any required packet check fails"), so the batch-operation validation cap does not apply.

5 / 5

Progressive Disclosure

The body is a clear overview with well-signaled one-level-deep references — both references/work-packet-template.md and references/agent-prompt-templates.md exist and match their links — and content is appropriately split, with orchestration logic inline and templates external.

5 / 5

Total

19

/

20

Passed

Description

53%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 states a clear, third-person "what" with a distinct batch-refactoring niche, but it omits any "Use when..." trigger clause and lacks natural trigger synonyms, leaving users without explicit activation guidance. Adding an explicit when-to-use clause with natural phrasing would raise both completeness and trigger term quality.

Suggestions

Add an explicit 'Use when...' clause (e.g., 'Use when a refactor spans many files or subsystems, or the user asks to parallelize or batch a large refactor') to satisfy the completeness requirement.

Include natural trigger synonyms such as 'large-scale refactor', 'batch refactor', 'rewrite', or 'restructure' so users' actual phrasing matches the description.

Consider adding a brief negative trigger (e.g., skip for single-file or tightly coupled edits) to further reduce overlap with general refactoring skills.

DimensionReasoningScore

Specificity

"Plan and execute large refactors" names the domain and two actions, with "dependency-aware work packets and parallel analysis" adding mechanism detail, but the action list is not comprehensive enough for the level-4 anchor, which expects several specific concrete actions.

3 / 5

Completeness

The "what" is clear (plan and execute large refactors via work packets and parallel analysis), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guideline.

3 / 5

Trigger Term Quality

"large refactors" is a natural user phrase, but common variations and synonyms are missing (rewrite, restructure, batch refactor, parallelize), and terms like "dependency-aware work packets" lean technical rather than user-natural.

3 / 5

Distinctiveness Conflict Risk

The parallel, dependency-aware batch-refactor niche is mostly distinct with concrete differentiators, though "Plan and execute large refactors" could minorly overlap with a general refactoring skill.

4 / 5

Total

13

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/orchestrate-batch-refactor/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.