Content
46%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 reads as a lean, boundary-conscious index to a contract bundle, but the bundle itself is missing: all ten referenced files (specs/*, BRIDGE-PLAN.md, MODELS.md, examples/*) are absent, so the skill delivers an overview with no reachable detail. Guidance is directional rather than executable, with no explicit workflow ordering, examples, or validation loop.
Suggestions
Ship the referenced bundle files (specs/identity.md, specs/ownership.md, specs/connections.md, specs/background-work.md, specs/subscriptions.md, specs/management.md, specs/user-choices.md, BRIDGE-PLAN.md, MODELS.md, examples/personal-mailbox-app.md) or inline the essential guidance from them; every link in the body currently points to a file that does not exist.
Add a concrete bridge-plan example or template (a few rows showing requirement → host operation → observable check) so the central artifact is executable rather than described.
Present the operating procedure as an explicit ordered workflow with validation checkpoints (inspect → map → confirm with user → implement → verify), especially the data-preservation and re-authority checks for repeated/delayed imports.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is compressed prose with no basic-concept padding, but scope-limiting statements repeat across paragraphs ("No AppLift runtime is needed", "Comprehensive observability ... are outside default scope", "The kit does not certify whole-product readiness", "this is not legal compliance certification") and several sentences could be merged or trimmed. Mostly efficient but could be tightened, matching the 3 anchor. | 3 / 5 |
Actionability | There are some concrete directives ("Inspect existing entities, IDs, auth, global credentials, queries and background operations. Mark mappings observed, proposed or unresolved"; "connect each consequential requirement to a host operation and observable check"), but key executable details are missing: no bridge-plan example or template, and the contracts that would carry the operational detail are referenced as files that are not present. Some concrete guidance but incomplete fits the 3 anchor; it exceeds 2 because the directives are specific, not just high-level hints. | 3 / 5 |
Workflow Clarity | A rough sequence is implied across paragraphs (inspect existing entities → mark mappings → ask business questions → read relevant contracts → record bridge plan → report implemented vs unrun), but it is never presented as an ordered workflow, and checkpoints are implicit rather than explicit validate-fix-retry steps. Because the skill touches data preservation and repeated imports ("A repeated import must preserve user-managed business progress"), the missing-validation cap holds the score at 3. | 3 / 5 |
Progressive Disclosure | The body is written as a well-signaled, one-level-deep index to specs/identity.md, specs/ownership.md, specs/connections.md, specs/background-work.md, specs/subscriptions.md, specs/management.md, specs/user-choices.md, BRIDGE-PLAN.md, MODELS.md and examples/personal-mailbox-app.md — but the bundle contains none of these files (only SKILL.md, config.json and rubrics/ exist). Scoring against the actual bundle structure, every reference dangles and navigation to any detail is impossible, which matches the 2 anchor (minimal structure; the promised separate content is absent). | 2 / 5 |
Total | 11 / 20 Passed |