Repository Overview
AchillesCopilotBasicSkills Documentation
This repository provides the standardized, reusable baseline catalog of self-contained skills for the team and for downstream projects that use Achilles, our libraries, and our technologies. The catalog is intentionally split between repository bootstrap skills, runtime convention skills, and skill-family construction guides that can bootstrap further skill types without coupling the runtime to external project code.
Use the generated specification matrix when changing repository rules. The DS set is the authoritative layer, while the HTML pages explain how those rules map to the current codebase and its portable skill folders.
Repository Model
This repository is not a deployable production runtime. Its purpose is to hold portable skill folders, example code that lives inside those folders, documentation, and validation tests. In downstream projects, the expected usage model is to copy the relevant folders under a local skills/ directory, often ignored by Git, and use them there without depending on repository-level source modules from this repository.
This repository documents the skill catalog because that is its own subject matter. A downstream project that merely consumes these skills should keep its docs/ tree focused on the host project and should not add DS files or HTML pages there whose topic is the imported skills; any skill-local notes should remain inside the copied skill folders.
Current Skill Catalog
| Skill | Role | Portable local code | Documentation |
|---|---|---|---|
gamp_specs |
Project bootstrap, agent guidance, DS policy, matrix generation, and HTML documentation structure. | examples/skillCatalog.mjs, docs scripts, specs loader asset, file size checker asset. |
Skill page |
achilles_specs |
AchillesAgentLib integration, runtime configuration, and LLM conventions. | examples/depsLoader.mjs, examples/runtimeConfig.mjs. |
Skill page |
article_build |
Self-contained article rebuilding, SVG validation, bibliography verification, and HTML emission. | Executable build modules and validators fully inside the skill folder. | Skill page |
review_specs |
Step-by-step review workflow for reconciling affected DS files with new context, instructions, and observed issues. | Descriptor and DS guidance only. | Skill page |
cskill_build |
Specification-driven executable skill conventions. | Descriptor and DS guidance only. | Skill page |
dgskill_build |
Dynamic code generation skill conventions. | Descriptor and DS guidance only. | Skill page |
oskill_build |
Declarative orchestration skill conventions. | Descriptor and DS guidance only. | Skill page |
antropic_skill_build |
Portable Anthropic-style self-containment baseline. | Descriptor and DS guidance only. | Skill page |
Repository Conventions
No shared production src tree
This repository intentionally avoids a root src/ runtime. Example code is stored inside the relevant skill folders so copied skills remain self-contained in downstream projects.
Tests are validation artifacts
tests/<skill-name>/ validates example code and scripts in this repository. Those tests are not deployment artifacts for downstream projects.
Downstream docs stay project-scoped
Projects that copy these skills should document their own architecture under docs/. Imported skill contracts stay inside the skill folders rather than being duplicated as project DS files or skill pages.
Coding style authority
DS001-coding-style.md defines modularity, file-size guidance, line-length expectations, and the use of fileSizesCheck.sh.
Documentation and Validation Flow
The specification matrix is generated from DS frontmatter metadata rather than handwritten list items. Ordinary DS files use Introduction, Core Content, Decisions & Questions, and Conclusion, with numbered question subchapters such as ### Question #1: ... inside the rationale section. Documentation work is expected to run npm run docs:matrix and npm run docs:verify-links, or the combined npm run docs:check, so that the matrix and the local HTML links stay synchronized with the actual files.