CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fastgpt-release-docs

仅在用户明确调用本 Skill 时,为 FastGPT 编写或更新指定版本的中英文 MDX 更新说明。支持 v4.17.3、4.17.3 或 4173 等版本输入,对比上一正式版本,按功能领域归并改动,先写中文再调用 doc-i18n 翻译英文。不自动用于普通代码任务或一般文档编辑。

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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, highly actionable instruction-only skill: concrete git commands and file paths, copy-ready templates, a clear five-phase workflow, and an explicit verification checklist with ask-don't-guess error handling. Remaining gaps are minor — some cross-section redundancy, missing exact lint command invocations, and no offloading of detailed editorial rules to reference files to slim the main SKILL.md.

DimensionReasoningScore

Conciseness

Dense prescriptive rules with no teaching of concepts Claude already knows, but some redundancy: the 镜像更新 rules appear in §3 ("编写前期通常留空…不自动填'待发布'等占位内容") and are restated in §5 ("镜像更新按发布阶段留空或保留人工内容"), and the commit/PR authorization note appears in both 调用与范围 and §5. This is 'minor instances that could be trimmed' (4) rather than 'every token earns its place' (5), and well above padded verbosity (3).

4 / 5

Actionability

Provides copy-paste-ready git commands with placeholders ("git log --oneline <base-sha>..<target-sha>", "git ls-tree <target-sha> pro"), exact file paths ("document/content/self-host/upgrading/4-17/4173.mdx", ".agents/skills/doc/i18n/SKILL.md"), a ready markdown template for the 升级指南 structure, and a concrete entry-format example. Not 5 because the verification tooling is named without exact commands ("运行仓库的 Prettier 和中文 textlint"); not 3 because the guidance is concrete and executable rather than pseudocode.

4 / 5

Workflow Clarity

Clear five-phase sequence (确认版本与比较范围 → 归纳主题 → 中文写作 → doc-i18n 翻译 → 验证与交付) with explicit checkpoints: fix both commit SHAs and report scope before analysis ("开始分析前固定两端 commit SHA,并向用户简要说明版本、比较范围和目标文档"), error-recovery paths that ask rather than guess ("仍无法确定时询问比较基准,不自行猜测"), and a full verification checklist in §5. Validation is explicit and comprehensive, satisfying the top anchor; the batch/destructive cap does not apply since validation steps are present.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the ~160-line body is organized into clearly sequenced, well-labeled sections with the domain-label table and templates inline where they are used. Most content is appropriately placed for a single-workflow instruction skill (4), but it is not 5: at this length, the detailed editorial rules (§3 label table and entry-format rules) could be offloaded to a one-level-deep reference file, and it is not 3 because nothing is buried and no content that clearly belongs elsewhere is inlined.

4 / 5

Total

17

/

20

Passed

Description

83%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 highly specific, well-scoped description that clearly defines what the skill does, accepts multiple version input formats, and restricts activation to explicit invocation with an explicit negative scope. Trigger-term coverage is good but would benefit from common synonyms such as release notes/changelog. The only structural weakness is that the 'when' clause expresses invocation mode rather than concrete natural trigger phrases.

DimensionReasoningScore

Specificity

Lists multiple concrete actions covering the full workflow: "为 FastGPT 编写或更新指定版本的中英文 MDX 更新说明", "对比上一正式版本", "按功能领域归并改动", "先写中文再调用 doc-i18n 翻译英文". Coverage within its niche is comprehensive, so it fits the top anchor rather than the 'minor gaps' anchor at 4.

5 / 5

Completeness

Both parts are explicit: the 'what' (write/update bilingual MDX release notes with comparison and domain merging) and the 'when' ("仅在用户明确调用本 Skill 时", reinforced negatively by "不自动用于普通代码任务或一般文档编辑"). The 'when' states an invocation mode rather than concrete natural trigger phrases, so it does not reach the fully explicit level 5, but explicit trigger guidance is present, keeping it above the level-3 cap.

4 / 5

Trigger Term Quality

Contains natural terms a user would say — "FastGPT", "更新说明", "版本", "MDX", and concrete input forms "v4.17.3、4.17.3 或 4173" — but misses common synonyms such as "发布说明", "更新日志", "changelog", or "release notes". Good coverage with a few natural terms missing places it at 4 rather than 5, and clearly above the sparse keyword coverage of 3.

4 / 5

Distinctiveness Conflict Risk

A clear niche — FastGPT release-notes authoring for a specified version — with explicit exclusion of adjacent uses ("不自动用于普通代码任务或一般文档编辑"), minimizing conflict risk with general documentation or i18n skills. This matches the 'clear niche with distinct triggers' anchor; no meaningful overlap remains to justify 4.

5 / 5

Total

18

/

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

labring/FastGPT

Path

.agents/skills/doc/fastgpt-release-docs/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.