apx-agent

Create and configure APX project agents with system prompts, identity metadata, and per-agent memory.

6|1|Updated May 8, 2026
One-click install
npx skills add https://github.com/agentprojectcontext/apx --skill apx-agent-agentprojectcontext
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apx-agent
Source: https://github.com/agentprojectcontext/apx/tree/main/src/core/runtime-skills/apx-agent
Command: npx skills add https://github.com/agentprojectcontext/apx --skill apx-agent-agentprojectcontext

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating an APX project agent without a system prompt silently produces a useless agent, and hand-editing agent files leaves the running daemon unaware of changes. This Skill guides the correct creation, configuration, renaming, and memory management of project agents so they actually work. ## Core Features & Use Cases - Agent creation with prompts: Create agents via the create_agent tool or apx agent add --prompt -, always including the body that becomes the agent's system prompt. - Identity configuration: Set typology (orchestrator, specialist, assistant, worker, monitor), org-chart area/role slugs, avatar blob icons, and per-agent models. - Lifecycle management: Safely rename agents with rename_agent (repointing all slug references), seed per-agent memory with write_agent_memory, and import agents from the global vault. - Use Case: You need a code reviewer agent for your project. Run apx agent add reviewer --type specialist --area engineering --prompt - with a heredoc containing its responsibilities and hard limits, then verify with apx agent get reviewer. ## Quick Start Ask the assistant to create a new APX project agent with a specific role, area, and a full system prompt describing its responsibilities and limits.

Frequently Asked Questions about apx-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an APX project agent with a system prompt?▼

Use the create_agent tool with slug and system parameters, or run apx agent add <slug> --prompt - with a heredoc containing the instructions. The prompt body is required; an agent created with only frontmatter metadata has no instructions and nothing errors.

How do I rename an APX agent safely?▼

Use the rename_agent tool with the agent and new name. It moves the definition file and runtime directory and repoints every reference to the old slug across routines, tasks, groups, and sessions. Editing the .md file or using configure_agent alone breaks those references.

Where is APX agent memory stored?▼

Agent memory lives in ~/.apx/projects/<apx_id>/agents/<slug>/memory.md and is never committed to the repo. Update it with the write_agent_memory tool or apx memory <slug> --append; nothing reads a memory.md under .apc/.

Why doesn't the daemon see my new agent after writing the file?▼

A raw write to .apc/agents/<slug>.md skips the daemon registry rebuild, so the running daemon won't see the agent. Use apx agent add/set, apx agent import, or the create_agent tool, which trigger the registry reload.

What agent types does APX support?▼

APX supports five types: orchestrator (coordinates and is marked master), specialist, assistant, worker, and monitor. Set the type field in the agent's frontmatter; only orchestrators and the super-agent can rename or remove other agents.

Can I set a different model per APX agent?▼

Yes. Set the Model field in .apc/agents/<slug>.md (for example ollama:llama3.2:3b) to override the global super-agent model. Leave it empty to follow the project or global default.