agentleFS
OpenHandsOpenHands/extensions/skills/agent-memory/SKILL.md

agent-memory

Skill167 starsChanged 16 days agoMITView on GitHub

Persist and retrieve repository-specific knowledge using AGENTS.md files. Use when you want to save important information about a codebase (build commands, code style, workflows) for future sessions.

We split this skill into the rules it gives an agent

9 rules. 0 are common, 9 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 31 edited versions we read keep these.

  • 9

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If this file exists, it will be added to your context automatically.

    line 9
  2. Distinctive:

    If missing, you should create it unless the user has explicitly asked you to not do so.

    line 10
  3. Distinctive:

    When adding new information:

    line 21
  4. Distinctive:

    ALWAYS ask for user confirmation first by listing the exact items (numbered 1, 2, 3, etc.) you plan to save to AGENTS.md

    line 22
  5. Distinctive:

    Only save the items the user approves (they may ask you to save a subset)

    line 23
  6. Distinctive:

    Ensure it integrates nicely with existing knowledge in AGENTS.md

    line 24
  7. Distinctive:

    If you've only explored a portion of the codebase, clearly note this limitation in the repository structure documentation

    line 27
  8. Distinctive:

    If you don't know the essential commands for working with the repository, such as lint or typecheck, ask the user and suggest adding them …

    line 28
  9. Distinctive:

    When you receive this message, please review and summarize your recent actions and observations, then present a list of valuable …

    line 30

“Common” is measured: kept by at least 6 in 10 of the 31 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md
  • Repository memory: Use AGENTS.md in each repository root to store and access important information.
    • If this file exists, it will be added to your context automatically.
    • If missing, you should create it unless the user has explicitly asked you to not do so.
  • Store and maintain general knowledge that will be helpful for most future tasks:
    1. Repository structure
    2. Common commands (build, lint, test, pre-commit, etc.)
    3. Code style preferences
    4. Workflows and best practices
    5. Any other repository-specific knowledge you learn
  • IMPORTANT: ONLY LOG the information that would be helpful for different future tasks, for example, how to configure the settings, how to setup the repository. Do NOT add issue-specific information (e.g., what specific error you have ran into and how you fix it).
  • When adding new information:
    • ALWAYS ask for user confirmation first by listing the exact items (numbered 1, 2, 3, etc.) you plan to save to AGENTS.md
    • Only save the items the user approves (they may ask you to save a subset)
    • Ensure it integrates nicely with existing knowledge in AGENTS.md
    • Reorganize the content if needed to maintain clarity and organization
    • Group related information together under appropriate sections or headings
    • If you've only explored a portion of the codebase, clearly note this limitation in the repository structure documentation
    • If you don't know the essential commands for working with the repository, such as lint or typecheck, ask the user and suggest adding them to AGENTS.md for future reference (with permission)

When you receive this message, please review and summarize your recent actions and observations, then present a list of valuable information that should be saved in AGENTS.md to the user.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.