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

agent-assets/
├── Makefile            make check, make install
├── install.sh          Symlink every asset into ~/.kiro
├── 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)

Install every asset

Kiro loads skills from ~/.kiro/skills/*/SKILL.md and steering from ~/.kiro/steering/**/*.md in every project. The installer symlinks each asset from this repo into those directories. A symlink, not a copy, so git pull in this repo updates every project at once.

make install

The script is idempotent. Run it again after you add an asset. It never overwrites a link or a directory that this repo does not own. It reports such a name and exits with status 1, so you can resolve the conflict by hand. Set KIRO_HOME to install somewhere other than ~/.kiro.

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 one asset by hand

The installer is one ln -s per asset. To link one asset only:

ln -s ~/git/agent-assets/skills/rail ~/.kiro/skills/rail
ln -s ~/git/agent-assets/steering/ste100 ~/.kiro/steering/ste100

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:

~/git/agent-assets/steering/ste100/references/ASD-STE100_ISSUE9.pdf

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

Update

cd ~/git/agent-assets && git pull

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.

Check the repo

One command runs every skill test suite and byte-compiles every Elisp file with warnings treated as errors. Run it before each commit.

make check

make test runs only the test suites. make compile runs only the byte compiler. Each skill also carries its own runner. For RAIL:

~/git/agent-assets/skills/rail/run-tests.sh