Content
78%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-engineered operational skill: fully concrete guidance, real validation guards on the write path, and exemplary progressive disclosure with a verified one-level-deep reference. The main cost is token efficiency — Key Behaviors, Anti-Patterns, and Usage Examples substantially overlap, and the body could shed a third of its length without losing any instruction.
Suggestions
Merge Key Behaviors into Anti-Patterns (or vice versa) — three of the six key behaviors are verbatim restatements of anti-pattern rules.
Trim Usage Examples to the one case not already derivable from the Commands table and Capture section (the bidirectional people-bridge detection), dropping the redundant list/map example.
Drop or demote the two background web links (Linking Your Thinking, YAML block scalars) to a single line — they spend tokens on context Claude does not need to execute the skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly operational, but there is real redundancy: Key Behaviors restates Anti-Patterns nearly verbatim ("Store verbatim. No reformulation" vs "NEVER reformulate"; "One-line capture response" vs "NEVER add unsolicited commentary"; "No GTD writes" vs "NEVER write to GTD"), and Usage Examples re-demonstrates what the Commands and Capture sections already specify. This fits the 'mostly efficient but could be tightened' anchor; not 4 because the duplication and marginal background links (LKT, YAML spec) are more than minor, not 2 because there is no padding that explains concepts Claude already knows. | 3 / 5 |
Actionability | Everything is executable for an instruction-only skill: exact filename pattern `{date}-{seq}-{source}-to-{target}.yaml`, a complete YAML schema with field-by-field semantics, a 4-step argument-parse procedure, keyword rules for direction/strength detection, exact one-line response templates, and concrete display formats for list/map/stats including a mermaid example. Not below 5: the common cases (capture, explicit type, bidirectional detection) are each covered by a worked example. | 5 / 5 |
Workflow Clarity | Each command has a numbered, clearly sequenced procedure with real checkpoints: the capture guard on workspace root, the config-missing warning, the mandatory seq check to prevent overwrites, and the duplicate check via `/bridge list`. Not 5 because there are no explicit error-recovery feedback loops (what to do after a warning fires is implied rather than specified); not 3 because validation guards for the risky write path (collisions, missing config, unknown aliases) are explicitly present. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview that defers the full archetype table and detection heuristics to references/archetype-detection.md, which exists in the bundle and is exactly the referenced content. The reference is one level deep and doubly well-signaled — inline with a when-to-load instruction ("load it before auto-detecting an archetype") and again in a References table with When-to-Use column. No content that belongs in a separate file is inlined. | 5 / 5 |
Total | 17 / 20 Passed |