skills.rest
ab300819
ab300819COMMUNITY
Explore all skills by this author →
GitHub

agent-memory

Creates, updates, and restructures AGENTS.md and CLAUDE.md agent memory files.

Updated Jan 12, 2026
Search Tags:#claude.md#agents.md#agent memory#documentation sync#project instructions#ai agent configuration
One-click install
npx skills add https://github.com/ab300819/keel-workflow --skill agent-memory-ab300819
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-memory
Source: https://github.com/ab300819/keel-workflow/tree/main/skills/agent-memory
Command: npx skills add https://github.com/ab300819/keel-workflow --skill agent-memory-ab300819

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agent memory files (AGENTS.md / CLAUDE.md) drift out of date, grow bloated, or become disorganized, causing agents to ignore rules or repeat questions. This Skill keeps project memory accurate, concise (60-line cap), and tool-agnostic by extracting facts from project sources. ## Core Features & Use Cases - Smart detection and creation: Scans package manifests, README, git history, and code structure to create AGENTS.md on first run, or detects whether an existing file needs updating or restructuring. - Update mode (--update): Extracts tech stack, ADR summaries, domain terms, active tasks, and run commands; for keel projects it also syncs numbering state into .claude/rules/devdocs-state.md with health-baseline size checks. - Restructure mode (--restructure): Reorganizes an existing AGENTS.md against best-practice rules (line limits, tool-agnosticism, anti-pattern detection) while preserving valid user rules. - Use Case: After finishing a development sprint, run the update mode so AGENTS.md reflects the current tech stack, active tasks, and workflow routing section without manual editing. ## Quick Start Ask the agent to run /agent-memory to detect the current state of the project's AGENTS.md and create or update it from project sources.

Frequently Asked Questions about agent-memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an AGENTS.md file for my project?▼

Run /agent-memory and it scans package manifests, README, git history, and code structure to generate AGENTS.md from a template. It also creates CLAUDE.md with an @AGENTS.md import if missing.

How do I update AGENTS.md after project changes?▼

Run /agent-memory --update to re-extract tech stack, ADR summaries, domain terms, active tasks, and commands from project sources. Existing user rules and the CLAUDE.md supplement section are preserved.

What is the difference between AGENTS.md and CLAUDE.md?▼

AGENTS.md holds tool-agnostic project instructions shared across AI tools. CLAUDE.md imports it via @AGENTS.md and adds a Claude Code-specific supplement section that this Skill never overwrites.

Why is AGENTS.md limited to 60 lines?▼

Bloated memory files cause agents to ignore important rules. The 60-line cap forces concise, high-value content; details stay in docs/ with only summaries and links in the memory file.

When should I use --restructure instead of --update?▼

Use --restructure when the file's organization is chaotic, violates best practices, or contains anti-patterns like tool-specific syntax. Use --update when the structure is fine but the information is stale.

Related Skills

Explore More Software Engineering Skills→
nholder88nholder88
2

draft-repo-readme

Draft a README from a repository's source files and commit history.

Community
Intermediate
ab300819ab300819

devdocs-onboard

Scan repository and DevDocs to generate a context document at docs/devdocs/00-context.md.

Community
Basic
xxyjxxyj

msx:verify

Automate pre-archive verification with linting, type checking, tests, and snapshot drift detection.

Community
Advanced
4lerman4lerman

remember

Save knowledge entries to auto-memory with timestamp and context.

Community
Basic