CtrlK
BlogDocsLog inGet started
Tessl Logo

deepchat-release

Prepare and publish DeepChat releases in this repository. Use when Codex needs to bump the app version, update CHANGELOG.md, keep release notes bilingual from v1.0.1 onward with English bullets first and Chinese bullets second, run release checks, create or update versioned release branches such as release/v1.0.1, continue a half-finished release, fast-forward main with the documented release flow, create or push version tags, or clean up release branches after publishing.

76

Quality

96%

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

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 body is a tightly written, repo-specific operational guide: an explicit mode-selection flow, copy-paste commands, safety guardrails around force-pushes and tag replacement, and a single well-signaled reference file holding the full command checklist. Its only weakness is mild duplication of the check commands and changelog format between SKILL.md and the reference file.

Suggestions

Trim the duplicated bilingual changelog template from the body (or from references/release-checklist.md §7) so the format is stated in exactly one place, keeping the body's pointer to the reference.

Replace the inline list of `pnpm run format` / `i18n` / `lint` commands with a single line deferring to the checklist's 'Recommended checks' section, since the reference already enumerates them.

Consider moving the 'Common Recovery Case' numbered steps into the checklist as mode 4b to reduce overlap with the 'update existing release branch' instructions.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — e.g. 'Check whether `release/<version>` exists locally or on `origin`' with no git tutorial — but there is duplication with the bundle reference: the check commands (`pnpm run format` / `i18n` / `lint`) and the bilingual changelog format block appear in both SKILL.md and references/release-checklist.md. This fits anchor 4 ('efficient; minor instances that could be trimmed') rather than 5, where every token would earn its place.

4 / 5

Actionability

Guidance is fully executable: exact commands (`pnpm run release:ff -- release/<version> --tag v<version>`, `--force-with-lease`), a copy-paste changelog template with date format, and a pointer to references/release-checklist.md for the full command sequence. Specific examples cover the common cases (four modes, recovery case); not score 4 because there are no gaps in executable detail.

5 / 5

Workflow Clarity

The sequence is clear (inspect state → choose mode → update metadata → run checks → branch policy → publish → clean up) with explicit validation checkpoints for the destructive steps: 'If a local or remote tag already exists on the wrong commit, stop and ask', 'Use this only after the release PR is approved', '--force-with-lease', and 'separate blocking failures from unrelated existing warnings'. This matches the anchor with explicit validation, error-recovery guidance, and a recovery case; not score 4 because no meaningful checkpoint is missing.

5 / 5

Progressive Disclosure

The body is a well-organized overview that defers exact commands to a real, clearly signaled one-level-deep reference ('Use [references/release-checklist.md](references/release-checklist.md) for exact commands') and points to the repository's docs/release-flow.md for full policy — the file exists in the bundle and is referenced with its purpose stated. Content is appropriately split with easy navigation; not score 4 because navigation and signaling are clean, not just mostly clean.

5 / 5

Total

19

/

20

Passed

Description

100%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 exemplary: it states a concrete 'what', provides an explicit and detailed 'Use when...' trigger list in third person, and anchors the skill to repository-specific artifacts (CHANGELOG.md, release/v1.0.1, version tags) that make it highly distinguishable. No fluff, over-claims, or padding are present.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — 'bump the app version', 'update CHANGELOG.md', 'keep release notes bilingual from v1.0.1 onward', 'run release checks', 'create or update versioned release branches such as release/v1.0.1', 'fast-forward main', 'create or push version tags', 'clean up release branches' — with comprehensive coverage of the release lifecycle. Not score 4: coverage is comprehensive rather than having minor gaps; not below because every action is concrete rather than generic.

5 / 5

Completeness

It explicitly answers 'what' ('Prepare and publish DeepChat releases in this repository' with an action list) and 'when' ('Use when Codex needs to bump the app version... continue a half-finished release... or clean up release branches') with concrete trigger phrases. This is the anchor-5 pattern; score 4 would require a less explicit 'when' clause, but the trigger list is explicit and specific.

5 / 5

Trigger Term Quality

Natural user phrasings abound: 'bump the app version', 'continue a half-finished release', 'clean up release branches after publishing', plus concrete file/branch patterns like 'CHANGELOG.md' and 'release/v1.0.1' that users would echo verbatim. This matches the anchor for comprehensive coverage including synonyms and file extensions; score 4 would require noticeably missing natural terms, which is not the case.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — this repository's DeepChat release process — with distinct triggers (release branches, version tags, fast-forward publish flow) that no generic git or changelog skill would claim. Minimal conflict risk; not score 4 because overlap with related skills is negligible, not minor.

5 / 5

Total

20

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
ThinkInAIXYZ/deepchat
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.