Skills referenced shared resources (scripts/, references/, schemas/) via paths
outside their own folder. When installed standalone via `npx skills add --skill`
or `cp -R skills/`, those external paths broke because only the skill folder
is copied.
Each skill now bundles its own copies of the scripts, references, and schemas
it needs. Root-level canonical copies remain for repo documentation and CI.
CONTRIBUTING.md documents which root files map to which skills.
Reorder README sections to front-load value: move How It Works and
Community Results above installation details, add an Every Second Counts
impact callout, rewrite How It Works with a mermaid orchestration diagram,
and add a What It Checks summary table linking to the new
OPTIMIZATION-CHECKS.md reference document.
OPTIMIZATION-CHECKS.md catalogues all 12 check categories with detailed
explanations and external references (Apple docs, WWDC sessions, articles).
Add Documentation Sync rules to AGENTS.md so future skill changes keep
README and OPTIMIZATION-CHECKS.md in sync.
User feedback showed the skills were over-indexing on cumulative task time
(which Xcode parallelizes) and presenting it as build-time savings. This led
to many source-level fixes that reduced compiler workload without actually
reducing how long the developer waits.
Key changes:
- AGENTS.md: wall-clock first principle inherited by all skills
- Orchestrator: blocking-vs-parallel heuristics, impact language templates,
wall-clock-first final report
- Report script/template: timing-table disclaimers, wait-time impact field,
plain-language verification
- Compilation analyzer: parallel workload labeling when not on critical path
- Project/SPM analyzers: wall-clock qualifier on prioritization tiers
- Fixer: wall-clock delta leads reporting, honest language when task metrics
improve but wait time does not
- Benchmark artifacts: documents wall-clock vs cumulative distinction
- Recommendation format: new wait_time_impact required field
- Added a new skill: `xcode-build-fixer` for applying approved optimization changes.
- Introduced `xcode-build-orchestrator` to manage the optimization workflow.
- Updated existing skills to reflect new names and roles, including `xcode-compilation-analyzer` and `xcode-project-analyzer`.
- Revised documentation across multiple files to include six installable skills and their purposes.
- Enhanced contribution guidelines to align with the new skill structure.
- Updated plugin metadata to reflect the addition of new skills.
First versioned snapshot of the full skill repository including:
- Five installable agent skills under skills/
- Shared references, schemas, and helper scripts
- Plugin and marketplace metadata for Claude Code
- GitHub workflows for release and README sync
- Compilation caching as a recommended build setting
- Four deeper Swift compiler diagnostic flags for compilation analysis
- Fixed SWIFT_COMPILATION_MODE to use singlefile (actual build setting value)
Antoine van der Lee