proactive-agent · halthelobster — Claude Code skill: features and installation
This skill gives an agent routines for retaining decisions, recovering context, and taking initiative. Use it when work needs to carry across sessions.
npx skills add halthelobster/proactive-agent --skill proactive-agent -a claude-codeWhat proactive-agent does
proactive-agent describes how an agent can act without waiting for a request and keep useful details between sessions. Its memory setup separates active task state, daily records, and curated long-term notes. Before answering questions about earlier work, the agent is told to search memory rather than guess.
When a user corrects something or makes a decision, the agent writes the detail to SESSION-STATE.md before replying. Once context reaches 60%, a working buffer records messages and brief response summaries for recovery after compaction. The quick start also copies Markdown assets into the workspace; that setup depends on those files being present.
Install it in Claude Code with npx skills add halthelobster/proactive-agent --skill proactive-agent -a claude-code. The quick-start process also runs ./scripts/security-audit.sh as a security check.
What it helps with
- carry decisions and corrections across sessions
- recover key details after context compaction
- search earlier work before answering questions
- keep user preferences in persistent memory files
Example prompts for the agent
- Save this decision to
SESSION-STATE.mdbefore replying. - Recover the relevant details from the working buffer after compaction.
- Search memory for our earlier work before answering.
How to install proactive-agent
1Skills CLI (Vercel)
npx skills add halthelobster/proactive-agent --skill proactive-agent -a claude-code2Manually: put the files in place
~/.claude/skills/proactive-agent/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/proactive-agent/
1Skills CLI (Vercel)
npx skills add halthelobster/proactive-agent --skill proactive-agent -a codex2Manually: put the files in place
.agents/skills/proactive-agent/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add halthelobster/proactive-agent --skill proactive-agent -a cursor2Manually: put the files in place
.cursor/skills/proactive-agent/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install halthelobster/proactive-agent proactive-agent2Manually: put the files in place
.github/skills/proactive-agent/SKILL.md1Skills CLI (Vercel)
npx skills add halthelobster/proactive-agent --skill proactive-agent -a gemini-cli2Platform CLI
gemini skills install https://github.com/halthelobster/proactive-agentManually: put the files in place
.devin/skills/proactive-agent/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add halthelobster/proactive-agent --skill proactive-agent -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about proactive-agent
How do I install proactive-agent in Claude Code?
Run npx skills add halthelobster/proactive-agent --skill proactive-agent -a claude-code. The skill file is at ~/.claude/skills/proactive-agent/SKILL.md.
What does proactive-agent do?
It sets out routines for agent initiative and persistent memory. The agent records key details before responding and retrieves them after context compaction.
How does proactive-agent preserve context during compaction?
At 60% context, the agent logs messages and short response summaries in a working buffer. After compaction, it reads that file first and pulls out relevant details.
Similar skills
All skills for Agent setup: memory, context, orchestration →proactive-agent by other authors comes first.
