actual CLI Skill

A feature-complete AI companion for the actual CLI, an ADR-powered CLAUDE.md/AGENTS.md generator.

What it does

• Runs and troubleshoots actual adr-bot with pre-flight → dry-run → execute → diagnose → retry
• Covers all 5 runners (claude-cli, anthropic-api, openai-api, codex-cli, cursor-cli)
• Covers all 3 output formats (claude-md, agents-md, cursor-rules)
• Includes error catalog, config reference, runner guide, and diagnostic script
• Works as inline knowledge AND operational automation

Install

Claude Code (recommended)

# Add this repo as a marketplace
/plugin marketplace add actual-software/actual-skill

# Install the plugin
/plugin install actual-cli@actual-cli-skills

Codex (OpenAI) — current skill install

$skill-installer install the actual skill from actual-software/actual-skill

ChatGPT and Codex plugin

This repository also contains a universal plugin manifest at .codex-plugin/plugin.json. During local testing, package the repository root as the actual-cli plugin and install it from a local marketplace. After public review and publication, install Actual CLI from the universal Plugins Directory shared by ChatGPT and Codex.

OpenCode / Cursor / Manual

Clone and symlink to your global skills directory:

git clone https://github.com/actual-software/actual-skill.git ~/.local/share/actual-skill

# For OpenCode
ln -s ~/.local/share/actual-skill/skills/actual ~/.config/opencode/skills/actual

# For Cursor
ln -s ~/.local/share/actual-skill/skills/actual ~/.cursor/skills/actual

# For Claude Code (alternative to marketplace)
ln -s ~/.local/share/actual-skill/skills/actual ~/.claude/skills/actual

# For Codex (alternative to $skill-installer)
ln -s ~/.local/share/actual-skill/skills/actual ~/.agents/skills/actual

Documentation

• Getting Started & Full Command Reference — human-readable docs
• docs.md — full docs in Markdown (machine-readable)
• llms.txt — concise LLM-friendly summary

Requirements

• The actual CLI installed (npm install -g @actualai/actual or brew install actual-software/actual/actual)
• At least one runner configured (see actual runners)

License

Apache-2.0