install

Installs aos capabilities into an agent harness with name gating, rendering, and diff-gated materialization.

3|1|Updated Jul 17, 2026
One-click install
npx skills add https://github.com/AlmogBaku/aos --skill install-almogbaku
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: install
Source: https://github.com/AlmogBaku/aos/tree/main/capabilities/capability-lifecycle/skills/install
Command: npx skills add https://github.com/AlmogBaku/aos --skill install-almogbaku

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new capability in an agent harness normally means hand-copying files, inventing names that may collide, and losing track of what was written where. This Skill turns capability installation into a repeatable, recorded procedure: it validates the package, checks for name collisions, personalizes the render against your MOD.md, and materializes everything behind a diff gate. ## Core Features & Use Cases - Validated installation pipeline: Resolves the capability directory, runs aos-cap manifest validation, checks installed versions, and installs missing dependencies first. - Name collision gating: Runs aos-cap skills --check and agents --check before writing anything, stopping on exit 17 so skill and agent names never clash across sources. - Personalized rendering: Runs the capability's onboarding interview, writes answers to MOD.md, and renders skills with {{mod}} slots filled per the overlay doctrine. - Diff-gated materialization: Stages symlinks, schedules, context blocks, and config keys, shows the full plan for approval, executes, records every artifact, and verifies with aos-cap verify. - Use Case: You tell your agent "install the work-tracker capability" — it resolves the package, installs the missing kb dependency first, interviews you, renders the skills, shows you the exact plan, and only then touches your harness. ## Quick Start Ask your agent to install a capability by name or path, for example: "Install the work-tracker capability from upstream into my harness."

Frequently Asked Questions about install

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install an aos capability into my agent harness?▼

Name the capability or point to its directory containing a CAPABILITY.md. The skill resolves the package, validates its manifest with aos-cap, installs missing dependencies, runs the onboarding interview, renders skills, and materializes everything behind a diff gate you approve.

What happens when a skill name is already taken during install?▼

The name gate runs aos-cap skills --check before anything is written. Exit 17 stops the install and reports which name is taken and by whom; the collision must be fixed in the package source, never by renaming during install.

Does install handle capabilities that depend on other capabilities?▼

Yes. Each capability listed in depends.capabilities that is missing from aos-cap list is installed first, including its own onboarding interview, before the requested capability proceeds.

What is the difference between install and capability-upgrade?▼

Install handles capabilities not yet present in the harness. If aos-cap show reveals an older version already installed, the skill hands off to capability-upgrade, which re-renders against fresher upstream sources.

How does install verify everything was written correctly?▼

After recording artifacts with aos-cap record, it runs aos-cap verify. Exit 13 means recorded hashes do not match disk — for example a link that is a copy or a missed render — and the skill fixes the mismatch immediately.