The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
OpenClaw skill and agent workflow system
AgentForge gives you a structured process for building skills and agents in OpenClaw. It includes templates, checklists, memory files, and example setups so you can move from idea to a production-ready workspace with fewer repeat mistakes.
Builders who want repeatable OpenClaw skill and agent creation with memory, tools, and handoff rules.
You can create agents and skills that keep context, learn from mistakes, and ship with a consistent setup.
What it does
Three creation modes
Supports new skills, new agents, and upgrades to existing workspaces.
Four-level memory system
Combines session context, file-based notes, vector memory search, and identity files like `AGENTS.md` and `SOUL.md`.
Auto handoff
Writes a save-state from session history so the agent can recover current decisions and TODOs after context resets.
Self-improvement loop
Turns repeated mistakes into patterns and then into new rules in `lessons.md`.
Skill and agent templates
Provides templates for skill types and a full 13-file agent layout.
Battle-tested pitfalls
Documents 22 common skill and agent mistakes to avoid during setup.
Ready-made examples
Includes five example skills such as weather, code review, task tracking, content planning, and meeting prep.
How to get it
- 1Run
# 1. Copy the skill mkdir -p <workspace>/skills/agent-forge/references cp SKILL.md <workspace>/skills/agent-forge/ cp references/agent-templates.md <workspace>/skills/agent-forge/references/ # 2. Restart the gateway (from terminal, not through agent) openclaw gateway restart
README
AgentForge for OpenClaw 🔧
v2.0 (2026-03-09) — 9-step agent pipeline with 4-level memory, self-improvement system, team alignment
Create skills and agents for OpenClaw. Full pipeline from idea to production-ready agent.
Public links / Полезные ссылки
- YouTube: https://youtube.com/@alekseiulianov
- Telegram channel - Sprut AI: https://t.me/Sprut_AI
- Telegram chat - Sprut AI: https://t.me/+eH-qNIDmud8zNDZi
- AI Операционка: https://t.me/tribute/app?startapp=sJyg
Canonical source
This project is maintained by Aleksei Ulianov / Sprut_AI. Original repository: https://github.com/AlekseiUL/agentforge-openclaw
If you found this project mirrored, repackaged, or redistributed elsewhere, check this repository as the source of truth.
Attribution
Where permitted by the applicable license, if you reuse, fork, modify, package, or publish this work, keep the original copyright and license notice and link back to the canonical repository.
Why
Most people create an agent by writing one AGENTS.md file and calling it done. Then they wonder why the agent gives generic answers, doesn't know who they are, forgets everything after context reset, and feels like a new hire on day one — every single time.
AgentForge codifies real battle-tested experience with dozens of skills and agents into a step-by-step process with checklists and templates.
Who is this for?
AgentForge is for OpenClaw builders who want repeatable agent and skill creation instead of one-off prompt files:
- creators building reusable OpenClaw skills;
- operators designing specialist agents with memory, tools, and handoff rules;
- teams that need checklists, templates, and pitfalls before shipping an agent;
- maintainers upgrading existing agents without losing identity or context.
It is not a generic chatbot prompt pack. It is a production checklist for agent workspaces.
Three Modes
| Mode | What it does | Steps |
|---|---|---|
| A: Skill | New skill from idea to test | 11 steps |
| B: Agent | New agent with memory and self-improvement | 9 steps |
| C: Improve | Upgrade existing skill or agent | 5 steps |
What You Get
Skill:
skills/my-skill/
├── SKILL.md # Logic + examples
├── data/ # Data files (safe from cleanup crons)
└── references/ # Details, dictionaries, guides
Agent (full):
~/.openclaw/agents/my-agent/agent/
├── AGENTS.md # Role, team, skills, memory, self-improvement
├── SOUL.md # Personality and principles
├── USER.md # Owner profile (adapted for agent's role)
├── IDENTITY.md # Name and description
├── MEMORY.md # Key facts summary
├── TOOLS.md # Real tools with commands
├── BOOTSTRAP.md # Context recovery after compactification
├── memory/
│ ├── lessons.md # Lessons and rules
│ ├── patterns.md # Self-improvement patterns
│ ├── projects-log.md # Task history
│ ├── architecture.md # Self-description
│ └── handoff.md # "Save game" of current conversation
└── skills -> /shared/ # Symlink to shared skills
Key Features
4-Level Memory System
- Contextual — current session
- File-based — lessons.md, patterns.md, projects-log.md (read on startup)
- Vector — memory_search across past conversations
- Identity — AGENTS.md, SOUL.md, USER.md (auto-loaded)
Auto Handoff (solves "agent gets dumb" problem)
Every hour a background task reads the session history and writes a "save game" — current topic, decisions, TODOs. When context resets, the agent recovers 95% of context in seconds. Before: lost 30-50%. Now: max 5%.
Self-Improvement System
Mistake → patterns.md → 3 repeats → new rule in lessons.md
The agent learns from corrections and stops repeating errors.
22 Battle-Tested Pitfalls
14 agent pitfalls + 8 skill pitfalls. Each one cost hours of debugging. You won't have to.
Skill Typology
4 types: Workflow / Role / Data-driven / Hybrid — with templates for each.
Agent Typology
3 types: Full (own bot, memory, skills) / Specialized (own ecosystem) / Mask (systemPrompt role)
Installation
# 1. Copy the skill
mkdir -p <workspace>/skills/agent-forge/references
cp SKILL.md <workspace>/skills/agent-forge/
cp references/agent-templates.md <workspace>/skills/agent-forge/references/
# 2. Restart the gateway (from terminal, not through agent)
openclaw gateway restart
Done. Tell your agent "create a skill" or "create an agent".
Quick Start
Skill:
"Create a skill for competitor analysis"
The agent asks 3-4 questions, determines the type, shows a draft, waits for approval, creates the structure.
Agent:
"Create a marketer agent"
The agent asks about: role, tools, memory, connections, binding. Creates config + all workspace files.
Examples
5 ready-made skills of different types in examples/:
| Example | Type | What it does |
|---|---|---|
| weather-bot | Workflow | Weather by city |
| code-reviewer | Role | Code review with rules |
| task-tracker | Data-driven | Task tracker with data/ |
| content-planner | Hybrid | Role + Workflow + references/ |
| meeting-prep | Workflow | Meeting preparation |
Files
| File | Contents |
|---|---|
SKILL.md | Main skill (521 lines, 3 modes, Russian) |
references/agent-templates.md | Templates for all 13 agent files |
examples/ | 5 example skills |
Triggers
"создай скилл", "новый скилл", "создай агента", "новый агент", "улучши скилл", "agent creator", "skill creator"
Requirements
- OpenClaw (any current version)
- Any model (Claude Sonnet 4.5+ recommended)
Author
Aleksei Ulianov — building AI agents on OpenClaw and sharing the experience.
- 🎬 YouTube: @alekseiulianov
- 📱 Telegram: @Sprut_AI
Want More?
This repo gives you the tool. But the full picture — my complete agent architecture, step-by-step setup guides, regular updates, Q&A, and everything I build for myself — lives in the private channel:
I build and improve my own agent system daily. Everything I learn, every new skill, every architectural decision — goes there first. It's not just instructions, it's a living knowledge base that grows with my experience.
License
MIT License. Copyright (c) 2026 Aleksei Ulianov / Sprut_AI.
AgentForge для OpenClaw 🔧
v2.0 (2026-03-09) — пайплайн из 9 шагов с 4-уровневой памятью, системой самообучения, командным выравниванием
Создание скиллов и агентов для OpenClaw. Полный пайплайн от идеи до production-ready агента.
Зачем
Большинство создают агента, написав один файл AGENTS.md и считая дело законченным. Потом удивляются почему агент дает общие ответы, не знает кто они такие, всё забывает после сброса контекста и ощущается как новичок в первый рабочий день — каждый раз.
AgentForge кодифицирует реальный боевой опыт с десятками скиллов и агентов в пошаговый процесс с чеклистами и шаблонами.
Три режима
| Режим | Что делает | Шагов |
|---|---|---|
| A: Скилл | Новый скилл от идеи до теста | 11 шагов |
| B: Агент | Новый агент с памятью и самообучением | 9 шагов |
| C: Улучшение | Апгрейд существующего скилла или агента | 5 шагов |
Что получаешь
Скилл:
skills/my-skill/
├── SKILL.md # Логика + примеры
├── data/ # Файлы данных (защищены от cleanup кронов)
└── references/ # Детали, справочники, гайды
Агент (полный):
~/.openclaw/agents/my-agent/agent/
├── AGENTS.md # Роль, команда, скиллы, память, самообучение
├── SOUL.md # Личность и принципы
├── USER.md # Профиль владельца (адаптированный под роль агента)
├── IDENTITY.md # Имя и описание
├── MEMORY.md # Ключевые факты (резюме)
├── TOOLS.md # Реальные инструменты с командами
├── BOOTSTRAP.md # Восстановление контекста после компактификации
├── memory/
│ ├── lessons.md # Уроки и правила
│ ├── patterns.md # Паттерны самообучения
│ ├── projects-log.md # История задач
│ ├── architecture.md # Самоописание
│ └── handoff.md # "Сохранение игры" текущего разговора
└── skills -> /shared/ # Симлинк на общие скиллы
Ключевые фичи
4-уровневая система памяти
- Контекстная — текущая сессия
- Файловая — lessons.md, patterns.md, projects-log.md (читаются при старте)
- Векторная — memory_search по прошлым разговорам
- Идентичность — AGENTS.md, SOUL.md, USER.md (автозагружаются)
Auto Handoff (решает проблему "агент тупеет")
Каждый час фоновая задача читает историю сессии и пишет "сохранение игры" — текущая тема, решения, TODOs. При сбросе контекста агент восстанавливает 95% контекста за секунды. Раньше: терялось 30-50%. Теперь: макс 5%.
Система самообучения
Ошибка → patterns.md → 3 повтора → новое правило в lessons.md
Агент учится на исправлениях и перестаёт повторять ошибки.
22 боевых питфола
14 питфолов агентов + 8 питфолов скиллов. Каждый стоил часов отладки. Вам не придётся.
Типология скиллов
4 типа: Workflow / Role / Data-driven / Hybrid — с шаблонами для каждого.
Типология агентов
3 типа: Full (свой бот, память, скиллы) / Specialized (своя экосистема) / Mask (роль через systemPrompt)
Установка
# 1. Копируем скилл
mkdir -p <workspace>/skills/agent-forge/references
cp SKILL.md <workspace>/skills/agent-forge/
cp references/agent-templates.md <workspace>/skills/agent-forge/references/
# 2. Перезапуск
openclaw gateway restart
Готово. Скажи агенту "создай скилл" или "создай агента".
Быстрый старт
Скилл:
"Создай скилл для анализа конкурентов"
Агент спросит 3-4 вопроса, определит тип, покажет черновик, дождётся одобрения, создаст структуру.
Агент:
"Создай агента-маркетолога"
Агент спросит про: роль, инструменты, память, связи, привязку. Создаст конфиг + все файлы workspace.
Примеры
5 готовых скиллов разных типов в examples/:
| Пример | Тип | Что делает |
|---|---|---|
| weather-bot | Workflow | Погода по городу |
| code-reviewer | Role | Ревью кода с правилами |
| task-tracker | Data-driven | Трекер задач с data/ |
| content-planner | Hybrid | Role + Workflow + references/ |
| meeting-prep | Workflow | Подготовка к встрече |
Файлы
| Файл | Содержание |
|---|---|
SKILL.md | Основной скилл (521 строка, 3 режима, русский) |
references/agent-templates.md | Шаблоны всех 13 файлов агента |
examples/ | 5 примеров скиллов |
Триггеры
"создай скилл", "новый скилл", "создай агента", "новый агент", "улучши скилл", "agent creator", "skill creator"
Требования
- OpenClaw (любая актуальная версия)
- Любая модель (Claude Sonnet 4.5+ рекомендуется)
Автор
Алексей Ульянов — строю AI-агентов на OpenClaw и делюсь опытом.
- 🎬 YouTube: @alekseiulianov
- 📱 Telegram: @Sprut_AI
Хочешь больше?
Этот репозиторий даёт инструмент. Но полная картина — моя полная архитектура агентов, пошаговые гайды по настройке, регулярные обновления, Q&A и всё что я создаю для себя — живёт в закрытом канале:
Я строю и улучшаю свою агентскую систему каждый день. Всё что я узнаю, каждый новый скилл, каждое архитектурное решение — сначала попадает туда. Это не просто инструкции, это живая база знаний которая растёт вместе с моим опытом.
Лицензия
MIT License. Copyright (c) 2026 Aleksei Ulianov / Sprut_AI.
Resources | Ресурсы
- 📺 YouTube: youtube.com/@alekseiulianov
- 📱 Telegram: t.me/Sprut_AI
- 🔥 AI ОПЕРАЦИОНКА (Premium): Подписка — продвинутые материалы, скиллы, агенты, поддержка
- 💻 GitHub: github.com/AlekseiUL
License
MIT License. Copyright (c) 2026 Aleksei Ulianov / Sprut_AI.
Building AI agents with soul since 2026 | Строю AI-агентов с душой с 2026
Files in the repo
- .github
- examples
- references
- banner.jpg
- LICENSE
- NOTICE.md
- README.md
- SECURITY.md
- SKILL.md
Discussion (0)
Ask about usage, or say what you built with itSign in to join the discussion.
No comments yet. Be the first to say what this is good for.
More harnesses
The job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
from vibe coding to agentic engineering - practice makes claude perfect
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.
Git. Ship. Done - Core