Project skills
What gets installed and how your agent uses it.
Installed with your project
For a new project on PhaseDrift 0.4.21 or later, run this from the repository you want to improve:
phasedrift init --host codex --local-onlyIt installs the skills below under .agents/skills/ and adds their reporting instructions to AGENTS.md. The example selects Codex and explicitly keeps hosted history and cloud report analysis off. Choose another supported host with --host opencode, --host claude-code, --host gemini-cli, --host cursor, or --host all; only selected hook-based hosts install their project hooks. You do not need a separate download after setup.
| Skill | Your agent uses it to |
|---|---|
| phasedrift | Read project evidence, investigate an obstacle, and track a fix |
| phasedrift-project-setup | Connect the project and diagnose collection problems |
| phasedrift-session-review | Get relevant guidance at task start and save the outcome at the end |
Make the instructions take effect
Reload your agent's project instructions or start its next conversation. The managed AGENTS.md block points it to the reporting skill. Host setup explains other entry files.
Keep that managed block. It is what asks the agent to start and report each meaningful task without you reminding it.
Check the installation
phasedrift doctor
phasedrift learning reportsAfter a normal task, look for the new report in Agent work → Reports. Installed files alone do not prove the agent followed them.
Refresh an existing project
After installing a newer CLI:
phasedrift init --host codex --upgradeReload the agent's instructions afterward. This preserves existing consent and unrelated instructions and settings; choose the host you already use when refreshing another integration.
Manual download
The skill kit contains the two helper skills and their references. The CLI generates the reporting skill for its installed version. The kit does not contain the application.
Download skills · File checksums
Install the kit manually
Compare the archive's SHA-256 with the manifest. On macOS:
shasum -a 256 "/path/to/phasedrift-agent-skills.zip"On Linux use sha256sum. Extract into the target project without replacing existing files:
cd "/path/to/your/project"
unzip -n "/path/to/phasedrift-agent-skills.zip"
phasedrift init --host codex --local-onlyPreserve customized skill files and compare differences before updating them.