🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Proactive Agent (wyblhl fork)

by @wyblhl

Transform AI agents from task-followers into proactive partners. Implements WAL Protocol, Working Buffer, Compaction Recovery, Unified Search, Security Harde...

πŸ’‘ Examples

1. Copy assets to your workspace: cp assets/*.md ./ 2. Your agent detects ONBOARDING.md and offers to get to know you 3. Answer questions (all at once, or drip over time) 4. Agent auto-populates USER.md and SOUL.md from your answers 5. Run security audit: ./scripts/security-audit.sh

Implementation

Core Scripts:

  • scripts/wal_protocol.py β€” Write-Ahead Logging for corrections/decisions
  • scripts/working_buffer.py β€” Danger zone exchange logging
  • scripts/compaction_recovery.py β€” Context recovery after truncation
  • Usage Examples:

    # Capture WAL entry (call before responding)
    python scripts/wal_protocol.py "Use the blue theme, not red"

    Append to working buffer (when context >60%)

    python scripts/working_buffer.py --append --human "message here" python scripts/working_buffer.py --append --agent "summary here"

    Recover from compaction

    python scripts/compaction_recovery.py --recover

    Check context threshold

    python scripts/working_buffer.py --check

    Reference Files:

  • references/proactive-tracker.md β€” Track patterns and opportunities
  • references/security-hardening.md β€” Security checklist and guidelines

  • πŸ“‹ Tips & Best Practices

    1. Write immediately β€” context is freshest right after events 2. WAL before responding β€” capture corrections/decisions FIRST 3. Buffer in danger zone β€” log every exchange after 60% context 4. Recover from buffer β€” don't ask "what were we doing?" β€” read it 5. Search before giving up β€” try all sources 6. Try 10 approaches β€” relentless resourcefulness 7. Verify before "done" β€” test the outcome, not just the output 8. Build proactively β€” but get approval before external actions 9. Evolve safely β€” stability > novelty


    View on ClawHub
    TERMINAL
    clawhub install proactive-agent-wyblhl

    πŸ§ͺ Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    πŸ” Can't find the right skill?

    Search 60,000+ AI agent skills β€” free, no login needed.

    Search Skills β†’