CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ir-record

IR 投资人关系数据库(SQLite):投资人档案、接触历史、项目申报三张表,含状态机推进与过期查询。

Quality

79%

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

Quality

Content

82%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 dense, executable reference: complete CLI contracts, full schemas, state machines, and check-first workflows with dedup checkpoints. The only real gaps are undocumented query-output formats and the absence of post-write verification loops.

DimensionReasoningScore

Conciseness

The body is a lean operational reference — schema tables, state-machine diagrams, CLI signatures, and usage rules — with no concept explanations Claude already knows and no padded sections; every section carries information needed to operate the tool (e.g., the application-status bullets genuinely disambiguate 'passed' vs 'rejected').

5 / 5

Actionability

Every command is a complete executable CLI signature with argument enums and required fields marked ("必填:--name、--type、--firm"), and check-* commands document their JSON output shape. Minor gap: output formats for query-progress/query-stale/query-applications are undocumented, unlike the check commands.

4 / 5

Workflow Clarity

The 使用规则 section sequences both workflows clearly with an explicit pre-write checkpoint ("先用 check-investor 判断是否已记录,已在数据库中则跳过") and idempotent init, plus stale-query sweeps as recurring checkpoints. It stops short of the top anchor because there is no post-write verification or error-recovery loop, which matters for database operations.

4 / 5

Progressive Disclosure

Well-organized single-file reference with clear sections (location, schema, commands, rules); the bundle is deliberately abstracted behind the PATH wrapper with an explicit instruction not to hand-assemble script paths, and the one external reference (expert-ir 包内 scheduling.md) is clearly signaled and one level deep. Minor gap: the 200-line schema/CLI reference could arguably live in a separate reference file, and the cross-package reference depends on material outside this bundle.

4 / 5

Total

17

/

20

Passed

Description

66%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 distinctive about what the skill manages, but it never states when Claude should use it. Adding an explicit trigger clause with natural user phrasings would lift it from good to excellent.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when tracking investors, logging investor contacts/跟进, or managing grant/competition applications (融资、投资人发掘与跟进、项目申报).'

Include natural synonyms users would actually say — 融资 (fundraising), 跟进 (follow-up), pitch, BP — to improve trigger coverage.

Mention the core operations (record / check-for-duplicates / update status / query pipeline) so the 'what' covers capabilities, not just table structure.

DimensionReasoningScore

Specificity

The description names concrete components — "投资人档案、接触历史、项目申报三张表" (three tables: investor profiles, contact history, project applications) plus "状态机推进与过期查询" (state-machine progression and stale queries) — several specific items with minor gaps, since the core operations (record/check/update/query) are only weakly implied by "过期查询".

4 / 5

Completeness

The "what" is clear (an IR SQLite database with three tables, state-machine progression, and stale queries), but there is no "Use when..." clause or equivalent trigger guidance — the rubric explicitly caps completeness at 3 for a missing 'when'.

3 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would say: "IR", "投资人关系", "投资人档案", "接触历史", "项目申报", "SQLite", "数据库". A few natural synonyms are missing (e.g., 融资/fundraising, 跟进/follow-up, pitch, BP, .db), so it falls short of the comprehensive-synonym anchor.

4 / 5

Distinctiveness Conflict Risk

"IR 投资人关系数据库(SQLite)" carves out a clear niche (investor-relations tracking) that is mostly distinct from generic database/SQLite or CRM skills, with only minor overlap risk; it lacks the fully distinct trigger phrases of the top anchor.

4 / 5

Total

15

/

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-ir/tools/ir-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.