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/
├── 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 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.

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

Confirm the link:

ls -l ~/.kiro/skills/rail

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:

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.

Test a skill

Each skill carries its own test runner. For RAIL:

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