catchclaw

What This Skill Does

The CatchClaw Agentar Manager is a robust tool designed to streamline the lifecycle management of agent templates, known as 'agentars'. An agentar acts as a portable, distributable archive (ZIP) containing the essential DNA of an AI agent, including workspace configurations, the SOUL.md personality file, and specialized skill sets. By utilizing this skill, users can interact with the CatchClaw marketplace to discover new capabilities, deploy pre-configured agents directly into their local environment, or package their own successful agent configurations for backup or sharing. The skill ensures that the agent workspace remains modular, allowing for seamless overwrites, rollbacks, and environment management.

Installation

The CatchClaw skill is pre-packaged with a bundled CLI utility, agentar_cli.mjs, which resides within the skill directory. No external installation is required. However, a mandatory security protocol exists: before performing any operations, the agent must verify the CLI integrity. This is achieved by running the command node <skill-dir>/agentar_cli.mjs version. Once this verification succeeds, the full suite of search, install, export, and rollback functions becomes available for active use in your local workspace.

Use Cases

This skill is perfect for developers and power users who frequently iterate on agent personalities or need to swap specialized workflows quickly. Use it to: 1) Discover community-built agents that handle specific tasks like coding or scheduling; 2) Maintain version control over agent workspaces by exporting stable configurations as ZIP files; 3) Restore a previous stable state using the rollback feature after an experimental change fails; 4) Rapidly bootstrap new agent instances using existing, proven agentar archives.

Example Prompts

1. "Search the CatchClaw marketplace for agentars that specialize in data analysis and install the highest rated one."
2. "Package my current workspace as an agentar named 'ProjectAlpha_v1' and save it to my exports folder."
3. "I broke my agent configuration, can you use the rollback command to restore it to the last stable state?"

Tips & Limitations

Always ensure the agentar_cli.mjs path is correctly resolved relative to the skill directory to prevent execution errors. If you are interacting with private registries, ensure the AGENTAR_API_BASE_URL is configured correctly, though the default https://catchclaw.me is sufficient for most users. Note that while this skill enables deep integration with the filesystem for workspace management, it requires proper permissions for reading and writing to ~/.openclaw/workspace. Never skip the version verification step, as it prevents potential runtime failures during critical file operations.