agent-apprenticeship

Name: agent-apprenticeship
Author: ray-r-ren

Pending

The living ecosystem where AI agents complete tasks through workflow loops, improve through iterative execution, are evaluated by mentor agents or humans in the loop, and turn completed work into reusable work experience and data to improve future agents.

1,316stars

56forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/ray-r-ren/agent-apprenticeship

Getting Started

Guides for using ai agents skills like agent-apprenticeship.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

README.md

Frequently Asked Questions

What is agent-apprenticeship?

agent-apprenticeship is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by ray-r-ren. The living ecosystem where AI agents complete tasks through workflow loops, improve through iterative execution, are evaluated by mentor agents or humans in the loop, and turn completed work into reusable work experience and data to improve future agents. It has 1,316 GitHub stars.

Is agent-apprenticeship safe to use?

agent-apprenticeship's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install agent-apprenticeship?

Clone the repository with "git clone https://github.com/ray-r-ren/agent-apprenticeship" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is agent-apprenticeship written in?

agent-apprenticeship is primarily written in Python. It is open-source under ray-r-ren on GitHub, so you can review or fork the full source.

Are there alternatives to agent-apprenticeship?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh agent-apprenticeship against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

effective-html vibeyard

Agent Apprenticeship

Real-world agent work experience, looped into collective learning.

npx agent-apprenticeship init

Agent Apprenticeship

As agents move into long-horizon, economically valuable work, Agent Apprenticeship creates the open infrastructure where real-world tasks generate reusable learning signals and complex workflows advance through agent loops that turn execution into shared improvement.

Agent Apprenticeship is designed for a compounding exchange of agent work experience: economically valuable task execution generates training signals, those signals improve future work, and future work creates new reusable experience for the ecosystem.

Agent Apprenticeship is built for iterative workflow loops across domains, from simple tasks to complex specialized work. Apprentice agents work with mentor agents, users, or human experts to complete real-world tasks, while each workflow generates reusable learning signals for the ecosystem.

The latest seed dataset includes:

500+ curated seed tasks sourced and grounded from the real world
495 reusable agent lessons
1000+ full agent execution traces
1000+ agent work episodes / task rollouts
505 full agent work experience compilations
39k+ structured experience compilation records

The seed dataset spans specialized, economically valuable tasks across domains and forms the first layer of the Agent Apprenticeship ecosystem.

Agent Apprenticeship is now available for anyone to start using with local agents, including Codex, Cursor, Claude Code, OpenClaw, OpenCode, Hermes Agent, and custom agents, alongside different model providers. Users can run automated agent workflow loops locally, contribute agent learning signals back to the ecosystem, and use shared ecosystem signals to improve their own agents.

Agent Apprenticeship is about the future of work and the economic value of agents. For every task executed through Agent Apprenticeship, the system can estimate task-level economic value, especially across specialized domains. It is built for everyday use to improve agent performance and outcome quality, while enabling users to exchange agent work experience with each other and with domain-expert-led agents in one living ecosystem.

Install

npx agent-apprenticeship init

Or install globally:

npm install -g agent-apprenticeship
apprentice init

The installed command is:

apprentice

The long-form command also remains available:

agent-apprenticeship

Quickstart

Start Agent Apprenticeship:

npx agent-apprenticeship init

Use defaults:

npx agent-apprenticeship init --defaults

Check your setup:

apprentice settings
apprentice doctor

Configure your Apprentice Agent, Mentor Model Provider, and Apprenticeship Mode:

apprentice configure
apprentice configure model
apprentice settings

Apprenticeship Modes:

Autonomous
Expert-Led
Organization Custom

Store Mentor Model Provider keys in:

~/.agent-apprenticeship/.env.local

Example:

OPENAI_API_KEY=""
ANTHROPIC_API_KEY=""
GEMINI_API_KEY=""
OPENROUTER_API_KEY=""

You can also use shell environment variables for the current terminal session:

export OPENAI_API_KEY="..."
apprentice doctor

Run your first task:

apprentice run "Create a short market map for AI procurement tools."

Watch progress:

apprentice watch <run_id>

When the run completes, Agent Apprenticeship prints the local run folder and Experience Compilation path.

Inspect the generated Experience Compilation:

apprentice ecosystem inspect <experience_compilation_path>
apprentice bundle check <experience_compilation_path>

Export the Full Experience Compilation:

apprentice ecosystem export <experience_compilation_path> --full

Install Runtime Training from prior experience:

apprentice learn install <experience_compilation_path>

Use installed Runtime Training in a future run:

apprentice run "Create a release checklist for an AI agent project."

Configure maximum loop depth:

apprentice settings

For a one-off terminal session:

export AA_MAX_ITERATIONS=3

Apprentice Agents

Available Apprentice Agents:

Codex
Cursor
Claude Code
OpenClaw
OpenCode
Hermes Agent
Custom

Agent Apprenticeship auto-detects installed CLIs. If multiple are detected, choose one during setup.

Custom lets you provide a command template:

apprentice configure agent custom --command-template "my-agent run --workspace {workspace} --prompt-file {prompt_file}"

Mentor Model Providers

Store local keys in:

~/.agent-apprenticeship/.env.local

Example:

OPENAI_API_KEY=""
ANTHROPIC_API_KEY=""
GEMINI_API_KEY=""
OPENROUTER_API_KEY=""

Configure:

apprentice configure model
apprentice doctor

Public Ecosystem and Private Internal Only

Configure contribution mode:

apprentice settings

Modes:

Public Ecosystem
Private Internal Only

Explore ecosystem experience:

apprentice ecosystem search <query>
apprentice ecosystem inspect <id>
apprentice ecosystem pull <id>

Export Full Experience Compilation:

apprentice ecosystem export <id_or_path> --full

Install Runtime Training:

apprentice learn install <id_or_path>

Seed Dataset v0.2

Seed Dataset v0.2 is available on Hugging Face:

https://huggingface.co/datasets/Forsy-AI/agent-apprenticeship-seed-dataset_v0.2

It includes 505 full agent work experience compilations and 39k+ structured experience compilation records.

Selected ALE Tasks Demo

Selected ALE workflow-family mirrored transfer tasks are included under:

selected_ale_tasks_demo/

Public Repo Structure

bin/
src/
schemas/
examples/
selected_ale_tasks_demo/