apx-skill-builder

Guides writing new APX skills with correct file location, frontmatter, and body style.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a skill for the APX super-agent requires knowing where the loader scans, how the frontmatter description triggers loading, and what body style the model expects. This Skill encodes those conventions so a new skill is discoverable and loads correctly on the first try. ## Core Features & Use Cases - File location rules: Explains the three scanned locations (project .apc/skills/, user-global ~/.apx/skills/, and runtime-internal src/core/runtime-skills/) and warns that <repo>/skills/ is never loaded by the super-agent. - Frontmatter and trigger guidance: Shows how to write the description field as a trigger condition with user phrases, plus the scope values (public, internal, optional). - Body style and workflow: Prescribes an opinionated structure (what-it-is paragraph, CLI calls, schema, anti-examples) with an 80-200 line budget, plus verification via apx skills list and apx exec. - Use Case: A developer adding a new capability to the APX super-agent uses this Skill to scaffold src/core/runtime-skills/my-thing/SKILL.md, write a triggerable description, and confirm it appears in apx skills list without restarting the daemon. ## Quick Start Ask the agent to load the apx-skill-builder skill and walk you through creating a new skill named my-thing in the runtime-skills directory.

Frequently Asked Questions about apx-skill-builder

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

FAQPage Schema
How do I create a new skill for the APX super-agent?▼

Create a directory like src/core/runtime-skills/my-thing/ containing a SKILL.md with name and description frontmatter, then write an opinionated body of 80-200 lines. Verify it loads by running apx skills list from the project root; no daemon restart is needed.

Where should APX skill files be placed to load correctly?▼

Skills are scanned in three locations: .apc/skills/ in the repo for project scope, ~/.apx/skills/ for user-global scope, and src/core/runtime-skills/ for built-in skills. The repo-level skills/ folder is not in the super-agent load chain and will never load.

What frontmatter does an APX SKILL.md require?▼

A SKILL.md needs a name and a description written as a trigger condition with user phrases that should cause loading. An optional scope field accepts public, internal, or optional; omitting it defaults to public.

Why is my APX skill not loading for the super-agent?▼

The most common cause is placing the skill in <repo>/skills/, which is only replicated to external CLIs and never loaded by the super-agent. Move it to .apc/skills/, ~/.apx/skills/, or src/core/runtime-skills/ and check with apx skills list.

When should I not write an APX skill?▼

Skip a skill for one-off explanations, casual chat, or anything fitting in two to three lines of the base prompt. Skills suit bounded topics like a tool, config domain, or recurring workflow needing more than 50 tokens of instruction.