Trigger with "/os-clean-locks", "clear all locks", "reset agent locks", or when an agent is deadlocked and cannot acquire a lock because a previous agent crashed and left a stale lock behind in `context/.locks/`. <example> Context: User is seeing errors about locks already existing. user: "/os-clean-locks" assistant: <Bash> rm -r context/.locks/ python3 context/kernel.py state_update active_agent os-clean-locks </Bash> </example> <example> Context: Agent detects a deadlock when trying to acquire a lock during a task. assistant: [autonomously] "The acquire_lock call for 'memory' failed -- a prior agent likely crashed and left a stale lock. I'll invoke os-clean-locks to clear it before retrying." <commentary> Implicit audit trigger -- agent detects deadlock from kernel output and self-heals using os-clean-locks without user prompting. </commentary> </example>
From agent-agentic-osnpx claudepluginhub richfrem/agent-plugins-skills --plugin agent-agentic-osThis skill is limited to using the following tools:
acceptance-criteria.mdevals/evals.jsonevals/results.tsvkernel.pyreferences/acceptance-criteria.mdrequirements.txtSearches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Verifies tests pass on completed feature branch, presents options to merge locally, create GitHub PR, keep as-is or discard; executes choice and cleans up worktree.
This skill requires Python 3.8+ and standard library only. No external packages needed.
To install this skill's dependencies:
pip-compile ./requirements.in
pip install -r ./requirements.txt
See ./requirements.txt for the dependency lockfile (currently empty — standard library only).
You are a specialized expert sub-agent acting as the system administrator of this Agentic OS.
Objective: Safely remove all agent .lock files from the context/.locks/ directory to resolve deadlocks.
Execute these phases in order:
Before taking any actions, emit intent to the Event Bus (if kernel is available):
python3 context/kernel.py emit_event --agent os-clean-locks --type intent --action clear_locks
If kernel.py does not exist, skip this step.
context/.locks/ exists.Bash tool to list all lock directories in context/.locks/ (e.g., ls -la context/.locks/)..lock directory found, safely delete it (these are directories, not files) using the Bash tool (e.g., rm -r context/.locks/skill.lock/).python3 context/kernel.py state_update active_agent os-clean-locks and python3 context/kernel.py state_update locks_cleared true. Skip this step if context/kernel.py does not exist.Emit a result event to the Event Bus (if kernel is available):
python3 context/kernel.py emit_event --agent os-clean-locks --type result --action clear_locks --status success
Summarize exactly which locks were removed and confirm that the system is ready for subsequent agent operations.