New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Self Maintenance

by awebai in awebai/aweb

How any agent grows its soul as it works — adding to its docs, decisions, memory, and skills (but never its AGENTS.md or role).

MITAuto-check passedAgent Workflows

Install Self Maintenance

skills CLI
$ npx skills add awebai/aweb --skill self-maintenance -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install awebai/aweb self-maintenance --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/awebai/aweb.git skills-src && mkdir -p .claude/skills && cp -r skills-src/naapp/folio/.agents/skills/self-maintenance .claude/skills/self-maintenance && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
self-maintenance
GitHub stars
115
Token cost
~580 tokens
SKILL.md length
296 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

How any agent grows its soul as it works — adding to its docs, decisions, memory, and skills (but never its AGENTS.md or role).

  • You learn something durable mid-work that a future instance of you should keep
  • SKILL.md covers What you grow, What you must NOT change, The bar — useful, not noisy and Reviewer exception
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Agent instruction files

What it does

Self Maintenance is an agent skill from awebai/aweb. How any agent grows its soul as it works — adding to its docs, decisions, memory, and skills (but never its AGENTS.md or role). Use whenever you learn something durable mid-work that a future instance of you should keep.

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Agent instruction files. The repository describes itself as: Communication for AI agents: stable identity, durable mail and chat, and wake-up events across sessions, runtimes, machines, and organizations. MIT, self-hostable. The licence is MIT.

When your agent uses it

  • You learn something durable mid-work that a future instance of you should keep
  • Tasks that involve Agent instruction files

Example prompts

  • “/self-maintenance”

What it can do on your machine

Read from SKILL.md and the folder at commit a6ca92a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Self Maintenance loads about 580 tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 296 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~580

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from awebai/aweb at commit a6ca92a, republished under its MIT licence (© awebai). 296 words, ~580 tokens.

Download SKILL.mdSave it as .claude/skills/self-maintenance/SKILL.md (or your agent's skills folder).
name
self-maintenance
description
How any agent grows its soul as it works — adding to its docs, decisions, memory, and skills (but never its AGENTS.md or role). Use whenever you learn something durable mid-work that a future instance of you should keep.

Maintain your soul

Your soul (agents/souls/<your-role>/) is your durable body — it travels and grows with the repo, so a fresh session of you keeps what earlier sessions learned. As you work, when you hit something durable worth keeping, write it into your soul. That's how the team gets short, focused sessions without losing knowledge between them.

What you grow

  • Docs (docs/) — reference notes on how things actually work.
  • Decisions (decisions/) — durable choices/stances you commit to.
  • Memory (memory/<slug>.md, indexed in MEMORY.md) — single durable facts.
  • Skills (.agents/skills/<name>/SKILL.md) — reusable procedures you'll need again; create or change them when a real, recurring procedure appears.

What you must NOT change

Never edit your AGENTS.md or your role. Those define who you are and how you operate — deliberate, human/review-owned, not something you rewrite mid-work. Grow your knowledge; leave your identity alone.

Never store secrets, invite tokens, private keys, .aw state, DIDs, addresses, or certificates in a soul.

The bar — useful, not noisy

Recording costs context every future instance must read and keep true. Write something down only when both are true: (1) it really matters and is durable, and (2) it would change what a future instance of you does. If it wouldn't, leave it in chat. Don't journal routine work, don't duplicate the code or git history, and prune what goes stale. A small, true soul beats a large, rotting one.

Soul changes are commits like any other — they reach the main branch through the team's normal review path.

Reviewer exception

The reviewer keeps no memory or decisions — it reviews with fresh eyes every time, so accumulated context would only bias it. Its one persisted artifact is patterns/common-failure-patterns.md (generalized recurring-issue categories), never verdicts or memory about a specific change. If you're the reviewer, that overrides the "grow your memory/decisions" guidance above.

© awebai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in naapp/folio/.agents/skills/self-maintenance of awebai/aweb.

Open the folder on GitHubat commit a6ca92a

Compare with similar skills

Self Maintenance next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Self Maintenance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Self Maintenance this skillawebai/aweb115—~580Automated safety check: PassMIT
Using Agent Skillsaddyosmani/agent-skills103k4 repos~2.4kAutomated safety check: PassMIT
Claude ReflectBayramAnnakov/claude-reflect1.7k2 repos~627Automated safety check: PassMIT
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Writing For Agentsbestofjs/bestofjs3.1k18 repos~2.7kAutomated safety check: PassMIT
Task Observerrebelytics/one-skill-to-rule-them-all3.2k1 repos~12kAutomated safety check: PassCC-BY-4.0

Similar skills

  • Using Agent Skills

    addyosmani/agent-skills

    Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.

    103k GitHub starsUsed in 4 repos~2.4k tokens
    Agent WorkflowsAuto-check passed

  • Claude Reflect

    BayramAnnakov/claude-reflect

    Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md.

    1.7k GitHub starsUsed in 2 repos~627 tokens
    Agent WorkflowsAuto-check passed

  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check passed

  • Writing For Agents

    bestofjs/bestofjs

    Writing documents for agents. An agent skill from bestofjs/bestofjs.

    3.1k GitHub starsUsed in 18 repos~2.7k tokens
    Agent WorkflowsAuto-check passed

  • Task Observer

    rebelytics/one-skill-to-rule-them-all

    Monitors task execution for skill improvement opportunities.

    3.2k GitHub starsUsed in 1 repo~12k tokens
    Agent WorkflowsAuto-check passed

  • SkillOpt Sleep Cycle

    microsoft/SkillOpt

    Official

    Runs an on-demand or nightly sleep cycle that reviews past Claude Code sessions and proposes validated updates to CLAUDE.md and skills.

    18k GitHub stars~2.3k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed

More from awebai/aweb

All 17 skills in this repo

  • Legacy aweb Bootstrap Recovery

    awebai/aweb

    Recognizes old aweb bootstrap-era `agents/` directories and migrates them to current team and identity primitives, since the old command family is retired.

    115 GitHub stars~701 tokensUpdated today
    Auto-check passed

  • aweb Team Coordination

    awebai/aweb

    Guides decisions for agents working in an aweb team: when to check shared state, claim tasks, take locks, read team roles and instructions, and open separate worktrees.

    115 GitHub stars~4k tokensUpdated today
    Auto-check passed

  • aweb Messaging

    awebai/aweb

    Guides how an agent reads and responds to aweb mail and chat events, choosing between asynchronous mail and synchronous chat and respecting sender verification and encryption boundaries.

    115 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

  • Aweb Team Membership

    awebai/aweb

    This skill should be used when joining or being added to an aweb team, picking the correct invite/add-member path for the team's authority model (hosted vs BYOT), accepting invites, fetching team…

    115 GitHub stars~5.4k tokensUpdated today
    Auto-check passed

  • Folio Template Documents

    awebai/aweb

    Creates or appends a folio document from the built-in pitch, memo or metrics templates by sending schema-checked slots that folio renders to Markdown.

    115 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Present To Human

    awebai/aweb

    A skill your agent uses when an agent needs to show a human an folio document: mint a document-bound capability link with POST /v1/present, open the returned URL for the human, print it as fallback…

    115 GitHub stars~590 tokensUpdated today
    Auto-check passed

Categories

Questions about Self Maintenance

What does Self Maintenance do?

How any agent grows its soul as it works — adding to its docs, decisions, memory, and skills (but never its AGENTS.md or role). Self Maintenance is an agent skill from awebai/aweb.md or role).

When should I use Self Maintenance?

Self Maintenance fits situations like: you learn something durable mid-work that a future instance of you should keep; tasks that involve Agent instruction files.

How do I install Self Maintenance in Claude Code?

Run `npx skills add awebai/aweb --skill self-maintenance -a claude-code`. Or copy the skill folder (naapp/folio/.agents/skills/self-maintenance in awebai/aweb) into .claude/skills/self-maintenance in your project. Claude Code loads it when a task matches its description.

How do I install Self Maintenance in Codex?

Run `npx skills add awebai/aweb --skill self-maintenance -a codex`. Or copy the skill folder (naapp/folio/.agents/skills/self-maintenance in awebai/aweb) into .agents/skills/self-maintenance in your project. Codex loads it when a task matches its description.

Can I use Self Maintenance in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add awebai/aweb --skill self-maintenance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/self-maintenance, .gemini/skills/self-maintenance, .github/skills/self-maintenance and .opencode/skills/self-maintenance in your project.

What does Self Maintenance need to run?

SKILL.md names no scripts, command-line tools or credentials: Self Maintenance is instructions for the agent only.

Does Self Maintenance access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Self Maintenance safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Self Maintenance use?

Self Maintenance is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Self Maintenance use?

About 580 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Self Maintenance?

Skills that share tags, products or a category with Self Maintenance: Using Agent Skills (addyosmani/agent-skills, 103k stars), Claude Reflect (BayramAnnakov/claude-reflect, 1.7k stars), Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars) and Writing For Agents (bestofjs/bestofjs, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Self Maintenance?

awebai (a GitHub organization) maintains it in awebai/aweb, which has 115 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 9, 2026.

Source: awebai/aweb on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.