Content
86%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 well-structured, highly actionable CLI guide with strong progressive disclosure — a navigation table routes every task to a real one-level-deep reference. It loses a point on conciseness (some reference-grade concept tables and login prose could live in bundle files) and a point on workflow clarity (destructive-op validation is delegated to references rather than surfaced inline).
Suggestions
Move the Key Concepts tables (Robot Types, Folder Types, Asset Types) and the platform hierarchy diagram into a reference file, keeping only a one-line pointer in SKILL.md to trim token cost.
Condense the multi-paragraph interactive-login warning into a short rule plus a single example; the core guidance ('ask the user to run ! uip login') can be stated in two sentences.
Surface a one-line destructive-op validation reminder inline (e.g., 'deletes require explicit per-turn approval — see data-fabric.md Critical Rules') so the body's own workflows carry the checkpoint rather than relying wholly on the reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and largely assumes Claude's competence (CLI commands, contracts, error shapes), but the Key Concepts section (platform hierarchy ASCII, Robot/Folder/Asset type tables) and the lengthy interactive-login prose include some explanation that could be trimmed or moved to references. | 4 / 5 |
Actionability | Concrete, copy-paste-ready commands throughout ('uip login status --output json', 'uip or folders list', 'uip df files upload <entity-id> <record-id> <field-name> --file <path>'), with explicit 'NOT' anti-patterns covering the common cases. | 5 / 5 |
Workflow Clarity | The Quick Start is a clear Step 1–4 sequence with an explicit validation checkpoint ('Always check first... if it reports Logged in, skip'), and the diagnostic-intent routing is well-sequenced; destructive-op validation is correctly delegated to data-fabric.md rather than inlined, leaving only minor checkpoint gaps in the body itself. | 4 / 5 |
Progressive Disclosure | A clean overview SKILL.md with a Task Navigation table mapping each need to one-level-deep reference files; all cited paths (uip-commands.md, data-fabric/*.md, guardrails/byo-configurations.md, licensing/*, etc.) resolve to real bundle files, with well-signaled links and content appropriately split. | 5 / 5 |
Total | 18 / 20 Passed |