Content
75%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a tight, executable reference for a simple gateway-wrapper skill: real commands with payloads, a versioned skill-ID table, and a useful mistakes table, with no tutorial filler. Its main defects are accuracy-of-detail rather than structure — a duplicated `.env` fallback entry, a repo-specific script path that does not resolve in this bundle, and no error-response guidance.
Suggestions
Fix the key-loading fallback list: items 2 and 3 both say "仓库根目录 .env" — either remove the duplicate or document the actual intended third source, and correct the same double-load in `scripts/ttfund-call.mjs` (`loadLocalEnv` calls `loadDotEnvFile` twice on the same path).
Make the script path match the bundle: the examples invoke `cat-cafe-skills/ttfund-skills/scripts/ttfund-call.mjs` but the file lives at `scripts/ttfund-call.mjs`; state the repo-root assumption once or use the bundle-relative path.
Add one line on handling gateway failures, e.g. that non-2xx responses raise `TTFund gateway HTTP <status>` with a truncated body, so the reader knows how to diagnose auth vs. payload errors.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no explanations of concepts Claude already knows — a gateway URL, four executable examples, a skill-ID table, and a mistakes table, every section earning its place. It is not a 5 because the key-loading list repeats "仓库根目录 .env" as both items 2 and 3 (one wasted/erroneous line) and every example command redundantly carries the long repo-specific path prefix "cat-cafe-skills/ttfund-skills/scripts/" that could be stated once. | 4 / 5 |
Actionability | Commands are concrete and copy-paste ready (`node ... ttfund-call.mjs FUND_SEARCH '{"query":"沪深300",...}'`) with real payloads, a `list` command, and a versioned skill-ID table covering the common cases. It is not a 5 because the documented script path `cat-cafe-skills/ttfund-skills/scripts/ttfund-call.mjs` does not resolve within this skill bundle (the file is at `scripts/ttfund-call.mjs`), and the key-loading fallback order is wrong (the same .env path listed twice, matching a script that also loads it twice, so a real third fallback is missing). | 4 / 5 |
Workflow Clarity | As a simple single-action skill (set TTFUND_APIKEY → run `list` → invoke a skill_id with a JSON payload) the single action is unambiguous, and the Common Mistakes table acts as error-avoidance guidance for key handling and versioning. It is not a 5 because the key-setup step is muddied by the duplicated fallback entry and there is no guidance on reacting to gateway error responses (e.g., the HTTP error the script can raise). | 4 / 5 |
Progressive Disclosure | The body is well organized into scannable sections (When to Use, Quick Reference, Skill IDs, Common Mistakes) with the single bundle script referenced one level deep and no nesting. It is not a 5 because the reference to the script uses a path that does not match the actual bundle layout (`scripts/ttfund-call.mjs`), and the 16-row skill-ID table duplicates data embedded in the script without pointing to it as the source of truth. | 4 / 5 |
Total | 16 / 20 Passed |