braid

Three strands. One skill collection.

braid is an open-source collection of reusable Agent Skills for software engineering, research and scientific publication, and teaching. The categories organize the source tree only. Installed skill names remain flat.

Skills

Software engineering

• engineering-plan-ontology: creates and maintains evidence-driven engineering plans that autonomous agents can execute safely.
• notebook-workflow: edits, synchronizes, and validates Jupyter notebooks, including paired Jupytext sources.

Research and publication

• manuscript-revision: revises scientific manuscripts while keeping claims, evidence, terminology, figures, and journal positioning aligned.
• notation-index-maintainer: creates and maintains repository-owned notation authorities and audits manuscripts for semantic notation conflicts.
• paper-support-release: builds and audits reader-facing repositories, archives, and deposits that support scientific papers.
• research-memo-maintainer: maintains a chronological, experiment-first research record with explicit provenance and claim boundaries.

Education

• coursework-design: designs and audits courses outcome-first, keeping assessment defensible now that students have capable AI assistants.

Install

Install from GitHub with skills:

npx skills add hermann-web/braid

Inspect the available skills without installing them:

npx skills add hermann-web/braid --list

Install one skill:

npx skills add hermann-web/braid --skill manuscript-revision

npx skills add hermann-web/braid --skill engineering-plan-ontology

Use npx skills list to inspect skills installed for the current project, or npx skills list -g for global installations.

Structure

skills/
├── software-engineering/
│   ├── engineering-plan-ontology/
│   └── notebook-workflow/
├── research-publication/
│   ├── manuscript-revision/
│   ├── notation-index-maintainer/
│   ├── paper-support-release/
│   └── research-memo-maintainer/
└── education/
    └── coursework-design/

Each skill is self-contained under skills/<category>/<skill-name>/. A skill always has SKILL.md and may include only the scripts, references, or assets it needs.

Contributing

Read CONTRIBUTING.md before proposing a skill. New skills must be reusable outside one repository, have precise activation boundaries, and pass local npx skills discovery.

Licence

braid is available under the MIT License.