CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

published-track

发布记录与指标数据库管理,负责记录入库、指标回填、查询和设置;具体平台取数由专家包的 engagement tool 完成,DNA 表现评估由 content-calibrator 消费。

Quality

75%

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 ./crews/main/skills/published-track/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%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 highly actionable, information-dense skill body whose commands are copy-paste ready and whose domain gotchas are genuinely non-obvious. The main gaps are validation checkpoints for batch/destructive database operations and an unreferenced bundle reference file that is undiscoverable from the SKILL.md.

Suggestions

Add validation steps around batch/destructive operations: e.g. run 'query-pending --platform <p>' to review affected rows before '--mark-all-distributed', and verify row counts/check a backup note before 'migrate-v3' on legacy databases.

Reference 'references/platform-constraints.md' from the body (e.g. a short '平台约束' section linking to it) so the bundle file is discoverable, or state explicitly that it is owned by the publish skills and move it out of this bundle.

Trim redundancy: the 16-platform list in the intro duplicates the platform table, and the platform-code mapping plus the restated 发布→记录 rule in '与发布技能的配合' could be condensed.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious operational specifics Claude cannot know (DB path, upsert semantics on (source_folder, publish_date), the wx_channel full-description title quirk, wrapper commands, no-$(date) sandbox warning). Not a 5: minor padding — the 16-platform enumeration in the intro duplicates the table below, and the '与发布技能的配合' section restates the 发布→记录 rule and platform-code mapping that could be trimmed or merged.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: complete 'published-track record' invocations with all flags for both the normal-publish and history-backfill cases, update-metrics examples, query/query-pending/check-published/set-distribute-status examples, and per-platform metric fields enumerated. These cover the common cases.

5 / 5

Workflow Clarity

Sequencing is good (发布→记录; numbered 流程 1/2A/2B/3A-3D; heartbeat pre-check that platform-status is ok=true/enabled=true before fetching), and the upsert action field gives a feedback signal. However, batch/destructive operations — 'set-distribute-status --mark-all-distributed' and the schema migration 'migrate-v3' — have no validation or verification steps, and the rubric caps workflow clarity at 3 for database/batch operations without validation.

3 / 5

Progressive Disclosure

The body itself is well-sectioned and the 11 scripts are clearly surfaced via the documented 'published-track <子命令>' wrapper. However, the bundle's reference file 'references/platform-constraints.md' is never mentioned anywhere in the body, leaving it buried and undiscoverable, and the full per-platform metrics table is inline SKILL.md content that could live in a reference. Scoring against the actual bundle structure, this is 'references present but not clearly signaled'.

3 / 5

Total

15

/

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.

The description clearly states what the skill does and carves out explicit boundaries against adjacent skills, with good domain keywords. Its main weakness is the complete absence of any 'use when' trigger guidance, which caps completeness at 3 and weakens trigger-term coverage.

Suggestions

Add an explicit trigger clause, e.g. '发布成功后、查询发布记录/待分发内容、补录历史作品或互动数据时使用' (Use when: recording a publication, querying publish status, or backfilling metrics).

Include concrete trigger keywords users would naturally say: '互动数据/engagement 数据', '发布记录', '待分发', and script/subcommand names like 'record', 'update-metrics', 'query-pending'.

Briefly mention the migration/status capabilities ('migrate-v3 旧库升级', 'platform-status 平台启用状态') so the description's action list matches the skill's actual coverage.

DimensionReasoningScore

Specificity

Names the domain ('发布记录与指标数据库管理') and several concrete actions ('记录入库、指标回填、查询和设置') plus explicit delegation boundaries. Not a 5: coverage is slightly compressed and misses capabilities present in the body (migrate-v3, platform-status); not a 3: it lists several specific actions, not just 1-2.

4 / 5

Completeness

The 'what' is clearly stated (database management of publish records and metrics: insert, backfill, query, set), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. The delegation sentences describe boundaries, not when to invoke this skill.

3 / 5

Trigger Term Quality

Contains natural domain keywords ('发布记录', '指标', '数据库', '回填', '查询', 'DNA 表现评估') a user in this domain would say. Not a 5: misses common synonyms like '互动数据'/'engagement 数据' and tool/script names (record.sh, update-metrics) that would serve as triggers; better than 3 since several relevant natural terms are present.

4 / 5

Distinctiveness Conflict Risk

Clear niche (publish-record tracking database) with explicit delineation from adjacent skills: platform data fetching is delegated to '专家包的 engagement tool' and DNA evaluation is consumed by 'content-calibrator'. Minimal conflict risk; not a 4 because the boundary statements explicitly separate it from the closest related skills.

5 / 5

Total

16

/

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.

Validation — 14 / 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

Total

14

/

16

Passed

Repository

TeamWiseFlow/xiaobei

Path

crews/main/skills/published-track/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.