Content
85%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.
A well-structured CLI skill body: lean routing with verified reference files, an explicitly validated workflow, and strong error-recovery guidance. The main costs are the duplicated reference listing and an over-long Principle 1.
Suggestions
Collapse the 'Reference index' section — it duplicates the Routing table's 19 file paths; a single lint-relevant listing suffices.
Trim Principle 1 to the actionable rule (try -h, then 'tcb help <cmd>', then 'tcb docs search'; absence from help ≠ deprecated) and move the command-status detail to references/core.md, which already holds the full status table.
Align the description's PostgreSQL/data-model claims with the body's routing (those tasks hand off to postgresql-development-cloudbase) to reduce sibling-skill trigger overlap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is imperative and free of basic-concept explanation, but Principle 1 is a long discourse on --help failure modes, and the 'Reference index' section re-lists all 19 files already enumerated in the Routing table — duplication that could be trimmed. | 4 / 5 |
Actionability | Concrete executable commands appear for the core path ('tcb login --intl true|false', 'tcb config set isIntl true|false', 'tcb env use <envId>', '--dry-run', 'tcb docs search "<keyword>"'), while domain specifics are deliberately deferred to references — minor gaps remain in the body itself. | 4 / 5 |
Workflow Clarity | The Quick workflow is a clearly sequenced 5-step process with explicit validation checkpoints (confirm envId, dry-run before destructive ops, verify via list/detail), a feedback loop for failures ('check the exit code... try a different approach'), and a self-check checklist — matching the top anchor. | 5 / 5 |
Progressive Disclosure | A routing table maps each task to a one-level-deep reference file, all 19 referenced files exist on disk, 'How to use' instructs loading only matching references, and external sibling-skill references include explicit missing-file handling. | 5 / 5 |
Total | 18 / 20 Passed |