#+TITLE: agent-assets
#+AUTHOR: Marius Peter
#+DATE: 2026-09-07
#+OPTIONS: toc:nil

Reusable Kiro agent assets, versioned in one place and shared across
every project. The repo holds more than skills. It collects every kind
of shareable agent configuration, installed into =~/.kiro= by symlink.

Content types, present and planned:

- *Skills* — on-demand slash commands, under =skills/=.
- *Steering* — always-on rules that shape every response, under
  =steering/=.
- *MCP servers* — planned. Tool servers the agent connects to, under
  =mcp/=.

Each type gets its own top-level directory. Add a new type by adding a
directory and a short section here.

* Layout

#+begin_example
agent-assets/
├── skills/
│   └── rail/           Skill — Rolling Action Item List
│       ├── SKILL.md
│       ├── rail-tools.el
│       ├── rail-tests.el
│       ├── run-tests.sh
│       └── references/
└── steering/
    └── ste100/         Steering — Simplified Technical English
        ├── ste100.md
        └── references/ ASD-STE100 PDF (supplied locally, not committed)
#+end_example

* Install a skill globally

Kiro loads skills from =~/.kiro/skills/*/SKILL.md= in every project.
Symlink a skill from this repo into that directory. A symlink, not a
copy, so =git pull= in this repo updates every project at once.

#+begin_src sh
ln -s ~/git/agent-assets/skills/rail ~/.kiro/skills/rail
#+end_src

Confirm the link:

#+begin_src sh
ls -l ~/.kiro/skills/rail
#+end_src

The global skills directory is package-managed by AIM, but AIM touches
only the skills listed in its =.aim-core-skills.json= manifest. A skill
from this repo is not in that manifest, so AIM leaves it alone.

* Install a steering module globally

Kiro loads steering from =~/.kiro/steering/**/*.md= in every project.
Symlink a steering module the same way:

#+begin_src sh
ln -s ~/git/agent-assets/steering/ste100 ~/.kiro/steering/ste100
#+end_src

A skill loads on demand. A steering module with =inclusion: always=
shapes every response, with no command.

** The STE100 reference PDF

The =ste100.md= doc points at =ASD-STE100_ISSUE9.pdf=, a paid,
copyrighted standard. The repo does not commit it. To use the full
reference, place your own copy at:

#+begin_example
~/git/agent-assets/steering/ste100/references/ASD-STE100_ISSUE9.pdf
#+end_example

The steering rules in =ste100.md= work without the PDF. The PDF only
serves the deep reference lookups that the doc mentions.

* Update

#+begin_src sh
cd ~/git/agent-assets && git pull
#+end_src

Every project that links a skill from this repo picks up the change on
the next session, with no copy step.

* Pin one project to an older version

The symlink shares one version across every project. To pin a single
project, place a copy of the skill under that project's own
=.kiro/skills/<name>/= instead of relying on the global link. A
workspace skill and a global skill of the same name both load, so remove
the global link for that project if you need only the pinned copy.

* Test a skill

Each skill carries its own test runner. For RAIL:

#+begin_src sh
~/git/agent-assets/skills/rail/run-tests.sh
#+end_src