apx-profile

Install, activate, configure, and diagnose APX agent profiles via CLI and HTTP endpoints.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an APX super-agent's line of work requires understanding the difference between installing, activating, configuring, and removing profiles, and mistakes like confusing install with use or off with uninstall lead to unexpected agent behavior. ## Core Features & Use Cases - Profile Lifecycle Management: Discover, install, activate, sync, and uninstall profiles (like secretary or project manager) with commands such as apx profile list, install, use, and off. - White-Label Configuration: Adjust per-profile settings like schedules, quiet hours, nudge budgets, and formality via apx profile config, with changes that actually reschedule cron routines rather than just editing JSON. - Diagnostics: Run apx profile doctor to detect missing requirements or drift between a package and its installed routines, and use --preview to inspect the rendered prompt block. - Use Case: When a user asks "why did my agent message me at 2am?", inspect the active profile's settings with apx profile show <id> --preview and fix the quiet hours with apx profile config --set quiet_hours=22:00-07:30. ## Quick Start Ask the agent to list available profiles and activate the secretary profile with a custom daily schedule.

Frequently Asked Questions about apx-profile

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

FAQPage Schema
How do I install and activate an APX agent profile?▼

Run `apx profile install <id>` to validate and register the package, then `apx profile use <id>` to activate it. Installing alone does not change behavior; activation writes config.profile.active, reloads the prompt, and installs the profile's routines.

What is the difference between apx profile off and uninstall?▼

`apx profile off` deactivates the profile and disables its routines but keeps all settings, tasks, and memory, so reactivating restores everything. `apx profile uninstall` removes the package and its routines while preserving routines the user edited or wrote.

Why did my APX agent message me unexpectedly?▼

Interruption behavior comes from the active profile's settings, not core APX. Inspect the prompt block with `apx profile show <id> --preview` and adjust nudge budgets, quiet hours, or staleness thresholds via `apx profile config`.

Can I run multiple APX profiles at the same time?▼

No, only one profile can be active at a time. Activating a second profile requires `apx profile use <id> --force`, which replaces the currently active one while preserving each profile's own settings.

How do I update installed profile routines after an APX update?▼

Run `apx profile sync` to re-render routines from the package on disk while leaving settings and activation untouched. Routines the user edited are skipped by design; use the readopt endpoint to force re-application past those skips.