Content
77%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.
An exceptionally actionable and well-sequenced audit skill with concrete grep patterns, Swift fixes, and explicit validation checkpoints. Its weaknesses are length/rationale prose that could be trimmed and a monolithic single-file structure with no local progressive-disclosure bundle.
Suggestions
Trim explanatory rationale in the Phase 3 question table and Pattern issue blocks (e.g., 'This is the single largest quality risk...') to leaner statements; the impact is already conveyed by the severity tag.
Move the OS27 error migration table and the per-pattern fix snippets into a local references/ file (e.g. foundation-models-fixes.md) and link one level deep, so SKILL.md stays an overview.
Add the 'Apple Intelligence' trigger synonym to the description and consider an Invocation-Examples trim, since the five example prompts plus the explicit-command line restate the same trigger surface.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~480-line body is mostly efficient and domain-specific, but it carries substantial explanatory rationale ('This is the single largest quality risk...', 'the model follows the most recent guidance') and rationale prose in the Phase 3/4 tables that could be tightened without losing the actionable signal. | 3 / 5 |
Actionability | Highly executable: runnable grep patterns per pattern, copy-paste Swift fix snippets for every issue, concrete verification steps, and a fully specified output template covering the common audit cases. | 5 / 5 |
Workflow Clarity | A clear five-phase sequence (Map → Detect → Reason → Cross-Reference → Score) with explicit validation checkpoints ('use Read to verify the surrounding context before reporting'), a false-positive checklist, and output-limit rules providing feedback loops for error recovery. | 5 / 5 |
Progressive Disclosure | Good section structure and signaled external references ('See axiom-ai (skills/foundation-models-ref.md) for the full migration table'), but no local bundle files exist in references/scripts/assets and the SKILL.md is a single monolithic file with the bulk of detail inlined rather than split into one-level-deep local reference files. | 3 / 5 |
Total | 16 / 20 Passed |