remove

Removes installed aos capabilities by walking lockfile entries backwards through jobs, symlinks, and config keys.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Uninstalling an agent capability by hand leaves behind cron jobs, symlinks, marker blocks, config keys, and orphaned agents scattered across your harness. This Skill removes an installed aos capability exactly and completely by walking its recorded lockfile entry backwards, so nothing is left behind and removal is verifiable. ## Core Features & Use Cases - Lockfile-driven removal: Reads the capability's recorded artifacts, links, schedules, config keys, and scripts via aos-cap show, then un-writes each one in the correct order. - Scoped or whole removal: Supports removing a capability from a single harness while it stays installed elsewhere, or removing it entirely across all harnesses. - Safety checks: Detects dependent capabilities before removal, preserves the user's personalized MOD.md answers, and asks before deleting machine-local state like kb-principal.yml. - Use Case: You installed a knowledge-base capability months ago and no longer use it. Ask your agent to remove it, and it deletes the jobs, symlinks, marker blocks, and tool binary, verifies nothing remains, and confirms your personalization file survives for a future reinstall. ## Quick Start Tell your agent to remove the installed capability by name, for example: remove the kb capability from my harness.

Frequently Asked Questions about remove

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

FAQPage Schema
How do I uninstall an aos capability from my agent harness?▼

Ask your agent to remove the capability by name. The skill reads the lockfile entry with `aos-cap show`, then un-writes jobs, symlinks, marker blocks, config keys, and the tool binary in order, finishing with `aos-cap remove` and a verification pass.

Can I remove a capability from one harness but keep it in another?▼

Yes, per-harness removal is supported. The skill un-writes only that harness's links, artifacts, and jobs, keeps the shared render and lockfile entry, and re-records the reduced set. Your MOD.md and the capability directory stay untouched.

Does removing a capability delete my personalization answers?▼

No, your MOD.md file always stays in your personal repo. Reinstalling the capability later brings it back fully personalized, since removal never touches the capability directory or its MOD.md.

What happens if another capability depends on the one I remove?▼

The skill checks the lockfile for entries whose manifest lists the target in `depends.capabilities` and stops with a warning. Removal only proceeds if you insist, in which case dependents are removed first.

When should I use capability-evolve instead of remove?▼

Use capability-evolve to undo a single setting or turn off one schedule. The remove skill is only for uninstalling an entire capability, not for partial configuration changes or retiring something upstream.