CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

huashu-agent-swarm

多Agent蜂群并行协作,纯git自组织,适合大型项目开发。当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用。

Quality

72%

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 ./huashu-agent-swarm/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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, largely executable orchestration guide whose main structural weakness is the total absence of validation checkpoints in a high-risk batch workflow that auto-merges branches. Secondary issues are wasted tokens on promotional content and one orphaned bundle file that is never surfaced.

Suggestions

Add explicit validation steps to the workflow: after Step 3 verify worktrees/tmux panes were created, and in Step 5 require checking agent logs and merge/test results before stop_swarm.sh cleans up worktrees.

Delete the promotional footer (公众号/粉丝数/代表作) and trim the opening epigraph — they consume context tokens without instructing Claude; move any Carlini context into references/carlini-lessons.md.

Link references/carlini-lessons.md from the body (e.g., under 核心机制) and replace <项目名>-style placeholders with one concrete worked example so commands are copy-paste ready.

DimensionReasoningScore

Conciseness

The body is mostly tight — bash commands, config tables, and risk tables carry information densely — but it spends tokens on non-instructional padding: the opening epigraph ('受Nicholas Carlini...启发') and the promotional footer ('花叔出品 | 公众号「花叔」| 30万+粉丝 | 代表作:小猫补光灯...') earn no place in the skill's token budget. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the lean anchor 5, and the advertising block is more than a 'minor instance' so it sits below anchor 4.

3 / 5

Actionability

Every step ships an executable command ('bash SKILL_DIR/scripts/setup_project.sh <项目目录>', 'python3 SKILL_DIR/scripts/dashboard.py <项目目录> 8420', 'tmux attach -t swarm-<项目名>') and all referenced scripts exist in the bundle. It stops short of anchor 5 because commands rely on unsubstituted placeholders (SKILL_DIR, <项目名>) with no worked example, and there is no guidance for the common failure cases (partial worktree creation, port conflict on 8420).

4 / 5

Workflow Clarity

The five-step sequence (描述项目 → 初始化 → 启动蜂群 → 观测 → 停止) is clearly ordered, but the workflow is a batch operation — it spawns ~8 autonomous agents that push code and Step 5 auto-merges branches and cleans worktrees with no validation checkpoint anywhere ('自动停止所有agent + 合并分支 + 清理worktrees'). Per the rubric's explicit cap, a batch workflow lacking verification steps cannot score above 3; the risk table gestures at monitoring ('日志监控 + 停止条件') but the steps themselves contain no verify-before-merge or check-output instruction.

3 / 5

Progressive Disclosure

The body is a well-structured overview that pushes detail to real bundle files: 'references/agent-prompt-template.md' is clearly signaled inline and exists, and all seven scripts referenced or tabulated (agent_loop.sh, dashboard.py, etc.) exist in ./scripts/. It misses anchor 5 because references/carlini-lessons.md sits in the bundle but is never linked or mentioned from SKILL.md (buried, undiscoverable), and there is no navigation pointer for dashboard usage details.

4 / 5

Total

14

/

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 serviceable bilingual description with an explicit 'use when' trigger clause and natural keywords, but its capability statement stays at the architecture level without naming concrete actions. Adding mechanism-level specifics (tmux, worktrees, task claiming, live dashboard) and the remaining trigger synonyms would lift it into the top band.

Suggestions

Add concrete capabilities to the 'what' clause, e.g. '启动多个Claude agent(tmux+git worktree),自动认领任务、写代码、推送,并提供实时看板' so specificity reaches the comprehensive anchor.

Include the missing trigger synonyms the body already uses ('infinite loop', '启动蜂群', '多agent并行') to broaden natural-term coverage.

Trim the vague qualifier '适合大型项目开发' or ground it in a concrete use case, since it adds claim without adding action.

DimensionReasoningScore

Specificity

The description states '多Agent蜂群并行协作,纯git自组织,适合大型项目开发' — it names the domain and two capabilities (parallel multi-agent collaboration, git-based self-organization), comparable to the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It does not reach anchor 4 because no concrete mechanism is listed (worktrees, tmux sessions, task claiming, dashboard) — '并行协作' and '自组织' are generic action words, so it also stays above anchor 2's 'actions are minimal or generic' since two distinct capabilities are named.

3 / 5

Completeness

Both halves are present: 'what' ('多Agent蜂群并行协作,纯git自组织,适合大型项目开发') and an explicit 'when' clause with concrete phrases ('当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用'), matching 'Has both what and when'. It falls short of anchor 5 because the 'what' is high-level — it never says what the skill actually does (launch agents, manage worktrees, monitor via dashboard) — so the what-side is less explicit than the anchor-5 example's concrete action list.

4 / 5

Trigger Term Quality

Trigger terms are natural and bilingual: '蜂群模式', '多agent', '并行开发', 'agent swarm' — phrases a user would plausibly say, matching 'Good keyword coverage; a few natural terms missing'. It misses anchor 5 because common variations the body itself lists ('infinite loop', '启动蜂群', '多agent并行') are absent from the description, leaving gaps in synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — git-organized agent-swarm orchestration — and its triggers ('蜂群模式', 'agent swarm') are distinctive phrases unlikely to fire for ordinary coding tasks, matching 'Mostly distinct; minor overlap risk'. It does not reach anchor 5 because '多agent' and '并行开发' are broad terms that could overlap with general multi-agent, orchestration, or parallelization skills in a crowded skill library.

4 / 5

Total

15

/

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

alchaincyf/huashu-skills

Path

huashu-agent-swarm/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.