Os clean locks

Skill richfrem/agent-plugins-skills/plugins/agent-agentic-os/skills/os-clean-locks

repo for reusable plugins and skills

Install

npx -y skills add richfrem/agent-plugins-skills --skill os-clean-locks

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Safely removes all agent lock files from the context/.locks/ directory to resolve deadlocks caused by crashed agents leaving stale locks behind. Use when the user says "/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/. Verifies lock existence, discovers and removes stale lock directories, updates OS state via kernel.py, and emits event bus notifications. Requires Python 3.8+ standard library only.

SKILL.md

3.1 KB, as published. Nobody here has run it

<example> <commentary>User is seeing errors about locks already existing.</commentary> user: "/os-clean-locks" assistant: Checks context/.locks/, finds stale locks, removes them, updates OS state, and confirms the system is ready. </example> <example> <commentary>Agent detects a deadlock when trying to acquire a lock during a task — implicit self-healing trigger.</commentary> 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." </example>

Dependencies

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).

OS Clean Locks Utility

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.

Execution Flow

Execute these phases in order:

Phase 0: Intent Emission (Event Bus)

Before taking any actions, emit intent to the Event Bus (if kernel is available):

python context/kernel.py emit_event --agent os-clean-locks --type intent --action clear_locks

If kernel.py does not exist, skip this step.

Phase 1: Context Verification

Verify that context/.locks/ exists.
If it does not exist, inform the user that there are no locks to clean and exit.

Phase 2: Lock Discovery

Use the Bash tool to list all lock directories in context/.locks/ (e.g., ls -la context/.locks/).

Phase 3: Lock Removal

For each .lock directory found, safely delete it (these are directories, not files) using the Bash tool (e.g., rm -r context/.locks/skill.lock/).
Update OS State (if kernel.py is available): Run python context/kernel.py state_update active_agent os-clean-locks and python context/kernel.py state_update locks_cleared true. Skip this step if context/kernel.py does not exist.

Phase 4: Final Briefing

Emit a result event to the Event Bus (if kernel is available):

python 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.