CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

using-superpowers

在开始任何对话时使用——确立如何查找和使用技能,要求在任何响应(包括澄清性问题)之前调用 Skill 工具

Quality

73%

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 ./skills/using-superpowers/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 body is a well-structured behavioral meta-skill: concrete announce and routing templates, a rationalization counter-table that doubles as a self-check, verified one-level-deep platform references, and explicit precedence rules for user instructions versus skills. Its only real weakness is token overhead from the emphatic <EXTREMELY-IMPORTANT> repetition and the repo-provenance commentary, neither of which adds runtime guidance.

Suggestions

Compress the <EXTREMELY-IMPORTANT> block from four sentences to one — keep "如果有 1% 的可能适用,必须调用" and drop the "你没有选择 / 这不可谈判" restatements, since the 红线 table already carries the enforcement.

Move the provenance blockquote (commit `392ff75`, PR #123, and the eval-evidence policy) to the repository's CLAUDE.md or a contributing guide; it addresses future editors of the skill, not the runtime audience.

Trim the editorial rationale in the 中国特色技能路由 section ("上下文里多一份排版参考不会让你写得更好,只会挤掉真正需要的内容") to a single normative sentence about explicit-invocation-only loading.

DimensionReasoningScore

Conciseness

Mostly efficient — the 红线 table rows and 平台适配 list are tight and assumption-free — but the <EXTREMELY-IMPORTANT> block spends four sentences ("你没有选择。你必须使用它。这不可谈判。你不能通过合理化来逃避。") restating one instruction, and the fork-provenance blockquote (commit `392ff75`, PR #123, eval-evidence policy) is repo history rather than runtime skill guidance. Matches the anchor for mostly efficient content that includes some unnecessary explanation. Not 4 because these are more than minor trims; not 2 because the majority of the body is lean with no re-teaching of known concepts.

3 / 5

Actionability

The guidance is directly executable throughout: an exact announce template ("宣布'使用 [技能] 来 [目的]'"), a concrete todo rule ("为每个条目创建一个待办"), concrete routing pairs ("'让我们构建 X' → 先用 brainstorming"; "'修复这个 bug' → 先用 systematic-debugging"; "/chinese-code-review" → chinese-code-review), and explicit file paths (`references/claude-code-tools.md` etc., all verified to exist). For an instruction-only skill this matches the fully-executable anchor whose specific mappings cover the common cases. Not 4 because there is no material gap — every instruction has a concrete object.

5 / 5

Workflow Clarity

The core loop is clearly sequenced — check skills before any response or action ("包括澄清性问题、探索代码库、或查看文件之前") → invoke → announce → follow strictly with todos — and the 红线 table ("这些想法意味着停下——你在合理化") plus the 技能优先级 and 用户指令 precedence rules act as self-check checkpoints for the primary failure mode. Matches the anchor for a clear sequence with most checkpoints present. Not 5 because how to discover which skills are applicable is never stated (left implicit to the platform references); not 3 because the sequence and all edge cases (unsuitable skill, conflicting skills, user-instruction override) are handled explicitly.

4 / 5

Progressive Disclosure

The body is a clear overview with nine condition-gated, one-level-deep references (Claude Code → `references/claude-code-tools.md` through Muse → `references/muse-tools.md`), every one of which exists in the bundle, and nothing that belongs in a reference file is inlined. Matches the anchor for a clear overview with well-signaled one-level-deep references and easy navigation. Not 4 because navigation is by explicit environment condition and the chinese-* table likewise signals exactly when (and when not) to load those skills.

5 / 5

Total

17

/

20

Passed

Description

58%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 explicitly answers both 'when' (start of any conversation, before any response including clarifying questions) and 'what' (skill lookup and Skill-tool invocation), which places it above most incomplete descriptions. It remains mid-rubric on specificity and trigger terms because it compresses its capabilities into one abstract purpose clause with few user-sayable keywords, and its universal trigger maximizes overlap with other skills by design.

Suggestions

Replace the abstract purpose clause "确立如何查找和使用技能" with enumerated concrete capabilities (e.g., 查找可用技能、按流程/实现优先级选择技能、在响应前调用 Skill 工具) to raise specificity.

Add natural trigger phrases and synonyms users would actually say (e.g., "该用哪个技能", "superpowers", "技能优先级", "开始对话前检查技能") alongside the current 对话/技能 keywords.

Pair the universal trigger "在开始任何对话时" with a distinguishing qualifier (e.g., naming this as the superpowers 入口/调度 skill) so it is distinguishable from other always-on meta skills.

DimensionReasoningScore

Specificity

The description names its domain ("查找和使用技能") and one concrete action ("要求在任何响应(包括澄清性问题)之前调用 Skill 工具"), but the lead clause "确立如何查找和使用技能" states an abstract purpose rather than enumerable capabilities — matching the anchor for naming the domain with 1-2 concrete actions. Not 4 because no list of several specific actions is given; not 2 because the Skill-tool invocation requirement is genuinely concrete.

3 / 5

Completeness

Both halves are explicit: the 'what' ("确立如何查找和使用技能…调用 Skill 工具") and a concrete 'when' ("在开始任何对话时使用" — use at the start of any conversation, before any response). Matches the anchor for having both 'what' and 'when' with room for more explicitness. Not 5 because the 'what' is stated as an abstract purpose rather than concrete capability phrases; not 3 because the 'when' clause is explicit, so the missing-trigger cap does not apply.

4 / 5

Trigger Term Quality

Relevant keywords are present ("对话", "技能", "Skill 工具") that a user needing skill-dispatch help could say, but there are no variations, synonyms, or scenario phrases (e.g. "该用哪个技能", "superpowers", "技能优先级") — matching the anchor for some relevant keywords while missing common variations. Not 4 because coverage is thin for a two-sentence description; not 2 because the terms are domain-accurate, not generic filler.

3 / 5

Distinctiveness Conflict Risk

The niche (skill-dispatch meta-behavior around "调用 Skill 工具") is clearly staked out, but the trigger "在开始任何对话时" is deliberately universal, overlapping every other skill's entry point — matching the anchor for a somewhat specific skill that can still overlap similar skills. Not 4 because an always-on trigger is more than minor overlap risk; not 2 because the content niche is distinct, unlike generic 'helps with documents' phrasing.

3 / 5

Total

13

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

jnMetaCode/superpowers-zh

Path

skills/using-superpowers/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.