skf-drop-skill

To safely remove outdated BMAD agent skills, you can soft deprecate specific versions in the export manifest without deleting files, or hard purge them from local disk storage with explicit user confirmation.

Yes, you can deprecate a specific skill version by marking it as deprecated in the export manifest, which makes the change reversible without deleting any files from disk.

Yes, dropping a BMAD agent skill automatically rebuilds managed sections and updates platform context files like AGENTS.md to remove references, keeping Claude Code, GitHub Copilot, and Cursor configurations consistent.

When you attempt to purge the only active version of a BMAD skill, the operation is blocked by safety guards that prevent removing the last active version and breaking your agent workflow.

Soft deprecation marks skill versions as deprecated in the export manifest without file deletion, making it reversible, while hard purge permanently deletes entire skills or specific versions from disk storage.

You should use a skill purge instead of manual deletion when you need active version protection, automated context file rebuilds across IDEs, and explicit confirmation safeguards to prevent breaking your BMAD project setup.