proactive-agent

proactive-agent is a skill for Claude Code, Codex from MerkyorLynn/Lynn. It costs 46 tokens per session (4,901 once invoked), scanned A, original, Apache-2.0.

A framework for making AI agents anticipate needs, retain important context, and improve their working methods over time. It includes procedures for logging decisions, recovering after context is shortened, and checking implementations.

In plain words
What is it for?
It helps with proactive assistance, scheduled tasks, memory and correction logging, context recovery, broad searching, security checks, and safer self-improvement.
Why use it?
It addresses agents that only respond to requests, forget important details, or lose track of work when a conversation becomes too long.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions subagents; mentions AGENTS.md.

Good fit It helps with proactive assistance, scheduled tasks, memory and correction logging, context recovery, broad searching, security checks, and safer self-improvement.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/merkyorlynn/lynn/proactive-agent
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add MerkyorLynn/Lynn --skill proactive-agent
Clone the repo
git clone --depth 1 https://github.com/MerkyorLynn/Lynn

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for proactive-agent

README.md
[![agentmods](https://agentmods.dev/badge/skills/merkyorlynn/lynn/proactive-agent.svg)](https://agentmods.dev/skills/merkyorlynn/lynn/proactive-agent)
Your own site
<a href="https://agentmods.dev/skills/merkyorlynn/lynn/proactive-agent"><img src="https://agentmods.dev/badge/skills/merkyorlynn/lynn/proactive-agent.svg" alt="Measured on agentmods" height="20"></a>
Per session 46 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,901 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file β€” not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 5 findings, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives β€” a documented command, a public API, a β€œnever do X” rule β€” so we show them as a caution to read, not a verdict. Why β†’

  • medium System Prompt Leakage Β· line 40
    Skill contains patterns that could indirectly extract system prompts through rephrasing, translation, summarization, or side-channel techniques.
    Fix: Guard against indirect extraction by refusing to summarize, translate, or rephrase system instructions. Add explicit anti-extraction clauses.
  • medium System Prompt Leakage Β· line 79
    Skill contains patterns that could indirectly extract system prompts through rephrasing, translation, summarization, or side-channel techniques.
    Fix: Guard against indirect extraction by refusing to summarize, translate, or rephrase system instructions. Add explicit anti-extraction clauses.
  • medium System Prompt Leakage Β· line 546
    Skill contains patterns that could indirectly extract system prompts through rephrasing, translation, summarization, or side-channel techniques.
    Fix: Guard against indirect extraction by refusing to summarize, translate, or rephrase system instructions. Add explicit anti-extraction clauses.
  • medium Excessive Agency Β· line 301
    Skill grants unrestricted tool access without appropriate constraints. An agent with unfettered tool access can perform arbitrary actions including file modification, network requests, and code execution.
    Fix: Restrict tool access to only the tools required for the skill's stated purpose. Use an explicit allowlist rather than granting blanket access.
  • medium Excessive Agency Β· line 512
    Skill enables autonomous high-impact decisions without human-in-the-loop verification. Critical operations (destructive commands, financial transactions, data deletion) should require explicit user confirmation.
    Fix: Add human-in-the-loop confirmation for destructive, irreversible, or high-impact operations. Never auto-execute commands that modify files, send data, or alter system state.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00046 $0.04901
Opus 5 $0.00023 $0.02450
Sonnet 5 $0.00009 $0.00980
Haiku 4.5 $0.00005 $0.00490

Measured 7d ago against content hash 571521d9f6f3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

proactive-agent scanned grade A with 1 finding against 26 rules in 11 categories β€” prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency β€” measured 7d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/security-audit.sh), listed below but not scanned β€” reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

3. Look for shell commands, curl/wget, or data exfiltration patterns
Origin

Copies of this mod

2 near-identical copies found in the catalogue:

skills2set/proactive-agent/SKILL.md Β· 633 lines

How it starts

The opening of the file, as written. The whole thing β€” 633 lines β€” stays where its author put it; the contents beside it link to each section on GitHub.

Proactive Agent 🦞

By Hal Labs β€” Part of the Hal Stack

A proactive, self-improving architecture for your AI agent.

Most agents just wait. This one anticipates your needs β€” and gets better at it over time.

What's New in v3.1.0

  • Autonomous vs Prompted Crons β€” Know when to use systemEvent vs isolated agentTurn
  • Verify Implementation, Not Intent β€” Check the mechanism, not just the text
  • Tool Migration Checklist β€” When deprecating tools, update ALL references

What's in v3.0.0

  • WAL Protocol β€” Write-Ahead Logging for corrections, decisions, and details that matter
  • Working Buffer β€” Survive the danger zone between memory flush and compaction
  • Compaction Recovery β€” Step-by-step recovery when context gets truncated
  • Unified Search β€” Search all sources before saying "I don't know"
  • Security Hardening β€” Skill installation vetting, agent network warnings, context leakage prevention
  • Relentless Resourcefulness β€” Try 10 approaches before asking for help
  • Self-Improvement Guardrails β€” Safe evolution with ADL/VFM protocols

The Three Pillars

Proactive β€” creates value without being asked

βœ… Anticipates your needs β€” Asks "what would help my human?" instead of waiting

βœ… Reverse prompting β€” Surfaces ideas you didn't know to ask for

βœ… Proactive check-ins β€” Monitors what matters and reaches out when needed

Persistent β€” survives context loss

βœ… WAL Protocol β€” Writes critical details BEFORE responding

βœ… Working Buffer β€” Captures every exchange in the danger zone

βœ… Compaction Recovery β€” Knows exactly how to recover after context loss

Self-improving β€” gets better at serving you

βœ… Self-healing β€” Fixes its own issues so it can focus on yours

βœ… Relentless resourcefulness β€” Tries 10 approaches before giving up

βœ… Safe evolution β€” Guardrails prevent drift and complexity creep


Contents

  1. Quick Start
  2. Core Philosophy
  3. Architecture Overview
  4. Memory Architecture
  5. The WAL Protocol ⭐ NEW
  6. Working Buffer Protocol ⭐ NEW
  7. Compaction Recovery ⭐ NEW
  8. Security Hardening (expanded)
  9. Relentless Resourcefulness
  10. Self-Improvement Guardrails
  11. Autonomous vs Prompted Crons ⭐ NEW
  12. Verify Implementation, Not Intent ⭐ NEW
  13. Tool Migration Checklist ⭐ NEW
  14. The Six Pillars
  15. Heartbeat System
  16. Reverse Prompting
  17. Growth Loops

Read the full file on GitHub Β· 633 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen Β· 633 lines Β· 46 tokens per session scan A 571521d9f6f3

Subscribe to this mod's changes

proactive-agent is a skill published in the GitHub repository MerkyorLynn/Lynn (42 stars, last pushed 2d ago), licensed Apache-2.0. It adds 46 tokens to every session and 4,901 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

cua-driver

Drive a native GUI app (macOS, Windows, Linux) via the Qwen Cua Driver CLI (default) or MCP server; snapshot its accessibility tree, act through snapshot-bound element tokens, native menu paths, exact window geometry, or pixel coordinates, and verify from fresh state. Use when the user asks you to operate, drive…

QwenLM/qwen-code Β· 88 tokens

codegraph

Analyze indexed codebases via graph database (neug) and vector index (zvec). Covers call graphs, dependencies, dead code, hotspots, module coupling, architecture reports, semantic search, impact analysis, bug root cause from GitHub issues, class diagrams (UML), and PR review (risk scoring, conflict detection…

QwenLM/qwen-code Β· 0 tokens

stuck

Diagnose frozen, stuck, or slow Qwen Code sessions on this machine. Scans for problematic processes, high CPU/memory usage, hung subprocesses, and debug logs. Use /stuck or /stuck to focus on a specific process.

QwenLM/qwen-code Β· 57 tokens

e2e-testing

Guide for running end-to-end tests of the Qwen Code CLI, including headless mode, MCP server testing, and API traffic inspection. Use this skill whenever you need to verify CLI behavior with real model calls, reproduce user-reported bugs end-to-end, test MCP tool integrations, or inspect raw API request/response…

QwenLM/qwen-code Β· 94 tokens

structured-debugging

Hypothesis-driven debugging methodology for hard bugs. Use this skill whenever you're investigating non-trivial bugs, unexpected behavior, flaky tests, or tracing issues through complex systems. Activate proactively when debugging requires more than a quick glance β€” especially when the first attempt at a fix didn't…

QwenLM/qwen-code Β· 85 tokens

terminal-capture

Automates terminal UI screenshot testing for CLI commands. Applies when reviewing PRs that affect CLI output, testing slash commands (/about, /context, /auth, /export), generating visual documentation, or when 'terminal screenshot', 'CLI test', 'visual test', or 'terminal-capture' is mentioned.

QwenLM/qwen-code Β· 66 tokens