_template_reference_first

To structure a reusable code skill with a reference-first architecture, use a standardized template that isolates routing logic, domain knowledge, machine-readable contracts, and deterministic execution scripts into distinct components. This separation of concerns ensures consistent skill development and easier maintenance.

A reference-first skill blueprint is a standardized template for creating reusable skills that enforces separation of concerns between routing, domain knowledge, contracts, and execution scripts. You should use it when developing new research assistant capabilities to scaffold a well-organized skill quickly.

Scaffold a new skill by copying a reference-first template directory. This approach separates core deterministic execution scripts from explanatory text and domain references, facilitating the creation of skills that are easy to understand, maintain, and reuse across different workflows.

Yes, this template enforces a clear division for deterministic execution scripts alongside routing logic and machine-readable contracts. It provides a standardized structure ensuring consistent skill design and separation of concerns for deterministic workflows.

The best way to maintain consistent skill development is to use a standardized template enforcing a reference-first architecture. It provides reusable components and a clear division between routing, domain knowledge, contracts, and scripts, ensuring skills remain easy to understand and maintain.

Your skill structure mixes concerns because it lacks a reference-first template enforcing separation. Using a standardized blueprint isolates routing logic in SKILL.md, domain knowledge in references, contracts in assets, and execution in scripts to prevent this issue.