https://github.com/chrisduvillard/pathfinder-skill
Pathfinder: an agent skill for Claude Code and Codex that maps an unfamiliar repo, picks the highest-value next move, and forges a bounded /goal.
https://github.com/chrisduvillard/pathfinder-skill
agent-skill ai-agents claude-code claude-code-plugin codebase-analysis codex developer-tools
Last synced: about 5 hours ago
JSON representation
Pathfinder: an agent skill for Claude Code and Codex that maps an unfamiliar repo, picks the highest-value next move, and forges a bounded /goal.
- Host: GitHub
- URL: https://github.com/chrisduvillard/pathfinder-skill
- Owner: chrisduvillard
- License: mit
- Created: 2026-06-15T17:42:56.000Z (11 days ago)
- Default Branch: main
- Last Pushed: 2026-06-23T15:55:21.000Z (3 days ago)
- Last Synced: 2026-06-23T17:29:03.745Z (3 days ago)
- Topics: agent-skill, ai-agents, claude-code, claude-code-plugin, codebase-analysis, codex, developer-tools
- Language: Shell
- Size: 193 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README-INSTALL.md
- License: LICENSE
Awesome Lists containing this project
README
# Pathfinder Skill Installation
This file is kept for users who open the original install note directly. The main repository README has the same information plus the safety model.
## Install with Claude Code `/plugin`
```text
/plugin marketplace add chrisduvillard/pathfinder-skill
/plugin install pathfinder@pathfinder
```
Then invoke the namespaced plugin skill:
```text
/pathfinder:pathfinder
```
Claude Code namespaces plugin skills as `/plugin-name:skill-name` to avoid collisions.
## Install with Codex `plugin`
```bash
codex plugin marketplace add chrisduvillard/pathfinder-skill
codex plugin add pathfinder@pathfinder
```
Then invoke it in Codex with `$pathfinder`, or run `/skills` to pick it.
Codex reads the marketplace entry from `.agents/plugins/marketplace.json` and the plugin manifest from `.codex-plugin/plugin.json` at the repository root.
## Manual Claude Code install
Copy this repo's `skills/pathfinder/` directory, including its `SKILL.md` and `references/`, to one of:
```text
/.claude/skills/pathfinder/
~/.claude/skills/pathfinder/
```
Invoke directly in Claude Code:
```text
/pathfinder
```
or:
```text
Use the pathfinder skill on this repository. Start the full Pathfinder process.
```
No separate slash-command wrapper is required.
## Manual Codex install
If your Codex setup supports Agent Skills, copy this repo's `skills/pathfinder/` directory (its `SKILL.md` and `references/`) to your Codex skills folder, commonly:
```text
~/.codex/skills/pathfinder/
```
Invoke it in Codex with `$pathfinder` or by running `/skills`. If your Codex runtime does not auto-discover skills, include `SKILL.md` as context and invoke it the same way.
## Claude Code `/goal` compatibility
`/goal` requires Claude Code v2.1.139 or newer.
Pathfinder saves both a ready-to-copy `/goal ` command and an equivalent `Implementation Goal` Markdown fallback for Codex, older Claude Code versions, or environments where slash commands cannot be executed directly.
The generated `/goal` condition is bounded, measurable, under the character budget, and requires the implementation agent to surface proof in the transcript because the `/goal` evaluator does not independently run tools or read files.