CtrlK
BlogDocsLog inGet started
Tessl Logo

co-creation-docs

共创型 docs-only 交付:区分只审阅与授权落盘,再按冲突、治理风险、可逆性决定 direct push、PR、cloud 与 full gate。

57

Quality

66%

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 ./cat-cafe-skills/co-creation-docs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 lean, well-structured decision lane with concrete commands, explicit validation, and a useful Common Mistakes checklist. It is held back from a 5 mainly by a small amount of backstory padding and validation loops that are implied rather than spelled out.

Suggestions

Make the validate→fix→retry loop explicit (e.g. 'if check-frontmatter fails, fix frontmatter and re-run until clean') to strengthen workflow clarity for the destructive push/commit path.

Trim the 价值门禁 backstory to a one-line rationale so every token earns its place.

Confirm the referenced scripts (check-frontmatter.mjs, check-feature-truth.mjs) exist in the bundle or note they are external, to close the actionability gap.

DimensionReasoningScore

Conciseness

Dense and information-rich throughout, assuming Claude's competence; the only padding is the 价值门禁 backstory paragraph, which could be trimmed without losing the rule.

4 / 5

Actionability

Provides concrete executable commands (pnpm classify:co-creation-docs …, node scripts/check-frontmatter.mjs …, pnpm check:co-creation-docs-lane) plus decision tables and numbered steps, with minor gaps where referenced scripts are not in the bundle.

4 / 5

Workflow Clarity

Clear intent → classify → deliver sequence with an explicit 验证 section and per-lane numbered steps; validation checkpoints are present though the validate→fix→retry loop is less explicit than ideal.

4 / 5

Progressive Disclosure

Single well-sectioned file with clear headers and no nested (2+ level) references; no bundle files exist to disclose into, so structure is appropriate with only minor organization gaps.

4 / 5

Total

16

/

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 is specific and well-differentiated within its niche, clearly stating the gating decisions it makes. It is held back by the absence of an explicit "Use when…" trigger clause and a reliance on technical jargon over natural user phrasing.

Suggestions

Add an explicit 'Use when …' trigger clause naming concrete user moments (e.g. co-authoring docs that should land, deciding whether a docs change needs a PR).

Soften technical jargon (治理风险、可逆性、full gate) by pairing each with a natural phrase a user would actually say.

Surface 1–2 natural synonyms (e.g. 'co-author docs', 'land documentation') to broaden trigger coverage.

DimensionReasoningScore

Specificity

Lists several concrete delivery outcomes — "区分只审阅与授权落盘" and "决定 direct push、PR、cloud 与 full gate" — naming the domain and multiple specific decision branches, with only minor coverage gaps.

4 / 5

Completeness

The "what" is clear (共创型 docs-only 交付 with risk-matched gating) but there is no explicit "Use when…" clause or equivalent trigger guidance, which caps completeness at 3 per the rubric.

3 / 5

Trigger Term Quality

Contains relevant keywords (docs-only, review, PR, direct push) but leans on technical jargon (治理风险、可逆性、full gate) and misses common natural phrasings a user would say.

3 / 5

Distinctiveness Conflict Risk

It carves a clear niche (co-creation docs-only delivery routing) with distinct triggers, with only minor overlap risk against adjacent merge-gate/PR skills.

4 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository
zts212653/clowder-ai
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.