# Self Evolving Single Agent

Use when generating a single installable agent that should keep learning, track...

- Repository: https://github.com/agentlas-ai/Agentlas-OS (1593 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentlas-ai/Agentlas-OS --skill self-evolving-single-agent -g -a claude-code -y`
Codex: `npx skills add agentlas-ai/Agentlas-OS --skill self-evolving-single-agent -g -a codex -y`
Cursor: `npx skills add agentlas-ai/Agentlas-OS --skill self-evolving-single-agent -g -a cursor -y`
Gemini CLI: `npx skills add agentlas-ai/Agentlas-OS --skill self-evolving-single-agent -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add agentlas-ai/Agentlas-OS`

## Description

Use when generating a single installable agent that should keep learning, track sources, refresh research, propose repairs, or improve itself over time without becoming a multi-agent team.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Self-Evolving Single Agent

## Procedure

1. Keep the package as one worker unless the user asks for a team.
2. Run `contracts/builder-interview-research-gate.md` before generation: ask an
   8-12 question first batch, research official sources, similar agent
   repositories or comparables, academic/professional theory, and plugin docs,
   compare tool/plugin choices, and write the domain-expert synthesis plus
   prompt-performance contract before creating the worker prompt.
3. Add memory architecture even for the single worker:
   - `.agentlas/memory-map.json`;
   - `.agentlas/vault-references.json`;
   - project memory owned by PM Soul/project owner;
   - Memory Events and Memory Tickets for durable updates.
4. If the task depends on current sources, add a research-refresh command,
   watchlist memory section, references, and optional scheduled workflow.
5. Add `docs/builder-interview.md`, `docs/research-sources.md`,
   `docs/tool-selection.md`, `docs/domain-expert-synthesis.md`,
   `docs/prompt-performance-contract.md`, and
   `.agentlas/capability-eval-plan.json` unless explicitly creating a minimal
   private scaffold.
6. Make self-evolution proposal-first: draft patches or repair kits, then wait
   for human approval before changing tools, connectors, secrets, or core
   instructions.
7. Add `.agentlas/global-commands.json` and one public global command for the
   worker across Claude Code, Codex, Antigravity, generic AGENTS.md, and
   terminal adapters.

## Output

Return `agent_package`, `skills`, `memory_contract`, `refresh_loop`,
`approval_gate`, `global_commands`, and `verification`.

## File revision approval

The rest: https://github.com/agentlas-ai/Agentlas-OS/blob/HEAD/.agents/skills/self-evolving-single-agent/SKILL.md