CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bd-record

BD 线索与互动记录数据库(SQLite):已探索创作者去重、已互动帖子去重。

Quality

77%

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/expert-bd/tools/bd-record/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

90%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 an efficient, highly actionable reference: executable commands with explicit JSON contracts, compact schema tables, and clear check-before/record-after dedup rules. Its only weaknesses are minor — no error-response handling in the workflows and an unexplained relationship between the PATH wrapper and the bundled scripts.

Suggestions

Add one line of error handling to the usage rules: on '{"ok": false, "error": ...}' report the error and do not mark the creator/post as recorded (so the dedup state stays truthful).

Briefly connect the 'bd-record' PATH wrapper to the scripts/ bundle (one line, e.g. which subcommand maps to which script) so the invocation path is self-explanatory.

DimensionReasoningScore

Conciseness

The body is lean and efficient — compact schema tables, bare executable commands with flags, and JSON return formats — with no explanation of concepts Claude already knows; every token earns its place, matching the 'lean and efficient' anchor.

5 / 5

Actionability

All commands are copy-paste ready with full argument lists (e.g. 'bd-record record-creator --platform ... --notes <备注>'), each returns an explicit JSON contract (e.g. '{"ok": true, "id": <记录ID>}' or '{"ok": false, "error": "..."}'), and init is stated as idempotent — fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

Both modes have an explicit check-before → skip-if-exists → record-after sequence with real checkpoints ('打开创作者主页前先用 check-creator 判断…已在记录中则跳过'), but there is no guidance for handling '{"ok": false, "error": ...}' responses or recovering from failed writes — a minor validation gap that keeps it below level 5.

4 / 5

Progressive Disclosure

Content is appropriately inline for a skill this compact, organized into clear sections (location, schema, commands, rules). Minor gap: the scripts/ bundle and the 'bd-record' PATH wrapper are never connected — the body says not to splice script paths but never explains how the wrapper maps to the bundled scripts, so organization is good but not fully self-navigating.

4 / 5

Total

18

/

20

Passed

Description

53%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 identifies a clear, distinct niche with a couple of concrete dedup actions, but it is terse to a fault: it lacks any 'when to use' trigger clause and only lightly covers the skill's actual capabilities. Adding an explicit usage trigger and naming the record/check operations would move it up.

Suggestions

Add an explicit trigger clause, e.g. 'Use when exploring creators or interacting with posts for BD lead hunting, or when checking whether a creator/post has already been handled.'

List the main concrete operations (check/record creators, check/record post interactions, init-db) so the 'what' is comprehensive, not just the two dedup use cases.

Include natural user-facing phrases/synonyms (记录潜客、已联系、重复、去重、check creator/post) to improve trigger term coverage.

DimensionReasoningScore

Specificity

Names the domain ("BD 线索与互动记录数据库(SQLite)") and two concrete actions ("已探索创作者去重、已互动帖子去重"), but omits recording leads, checking/ recording posts, and init — comprehensive coverage is missing, matching the 'domain plus 1-2 concrete actions' anchor rather than the fuller action list of level 4.

3 / 5

Completeness

The 'what' is reasonably clear (a BD lead/interaction SQLite database for dedup), but there is no 'Use when...' or equivalent trigger clause at all — per the judging guideline this caps completeness at 3, and it cannot reach 4 without any explicit 'when'.

3 / 5

Trigger Term Quality

Relevant domain keywords are present ("BD", "线索", "创作者", "帖子", "去重", "SQLite") but common natural variations users would say (e.g. "记录潜客", "已联系过的创作者", "check 重复") are missing, fitting the 'some relevant keywords but missing variations' anchor rather than the good coverage of level 4.

3 / 5

Distinctiveness Conflict Risk

The BD lead-hunting dedup niche is distinct with low overlap risk against typical skills; it falls short of level 5 only because the terse description leaves trigger boundaries under-specified, staying at 'mostly distinct; minor overlap risk'.

4 / 5

Total

13

/

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

TeamWiseFlow/xiaobei

Path

crews/main/skills/expert-bd/tools/bd-record/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.