compass-skills: Instructions file for Codex

COMPASS Agent Adapter

This repository contains agent-agnostic SKILL.md skills. Use this file when your agent does not have native skills support, or when it needs explicit rules for discovering and applying the skills in skills/.

Discovery

• Available skills live under skills/<skill-name>/SKILL.md.
• Read each skill's YAML frontmatter name and description to decide whether it applies.
• Prefer explicit user invocation such as $task-clarifier, $task-forest, $pause-and-resume, $session-handoff-prompt, $user-profile-keeper, $run-history-skill-builder, $run-history-skill-upgrader, or $assess-interview-candidate.
• If no skill clearly applies, continue normally; do not force a skill.

Loading Protocol

When a skill applies:

1. Read the full SKILL.md before acting.
2. Resolve relative paths from the directory that contains that SKILL.md.
3. Read referenced files under references/ only when the skill tells you to or when the current task needs them.
4. Run scripts from the skill's own scripts/ directory instead of retyping large logic.
5. Keep generated runtime data out of the repository unless the user explicitly asks to commit it.

Invocation Examples

Use $task-clarifier to align this task before implementation.
Use $task-forest to update the task graph for this workspace.
Use $pause-and-resume to pause this unfinished task in the current conversation; later, continue it from the checkpoint.
Use $session-handoff-prompt to create a continuation prompt for a fresh session.
Use $user-profile-keeper to initialize or update my local profile.
Use $run-history-skill-builder to turn this completed workflow into a new skill package.
Use $run-history-skill-upgrader to plan a safe upgrade for this existing skill from recent run evidence.
Use $assess-interview-candidate to turn an authorized resume and job description into an auditable local interview report.

Local Paths

• task-forest writes task data under the current workspace: .agent-workbench/task-forest/.
• pause-and-resume keeps its checkpoint in the current conversation and creates no files solely for pausing.
• session-handoff-prompt is read-only by default. It may validate local handoffs with real workspace paths or redact shareable handoffs.
• user-profile-keeper writes profile data under the local user home: .compass-skills/user-profiles/v1/.
• run-history-skill-builder writes new skill packages only to a user-approved local directory.
• run-history-skill-upgrader is plan-only by default and edits existing skills only after explicit approval.
• assess-interview-candidate writes case data and reports only below a user-approved local case root; generated candidate records stay outside this repository.
• Set COMPASS_USER_PROFILE_HOME to override the profile directory.
• Set COMPASS_AGENT_NAME to label task-forest changes by agent, for example codex, claude-code, opencode, or openclaw.