Skip to content

feat/configurable paths #12

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jcyamo wants to merge 3 commits into
base: main
Choose a base branch
from
Open

feat/configurable paths #12

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ff79372
feat: make skills and vault paths user-configurable
jcyamo Jun 4, 2026
23464ca
feat: show per-skill categorization detail in --dry-run
jcyamo Jun 4, 2026
70c9d03
fix: safe symlink handling and explicit move dest in execute_migration
jcyamo Jun 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -100,6 +100,26 @@ python setup.py --agent claude
```
*(Note for Claude Code: The `.skillpointer-vault` directory is intentionally prefixed with a dot so Claude's aggressive file scanner natively skips it during Level 1 context hydration).*

**Custom paths:**
The `--agent` presets are just defaults. Point the script at any skills directory and vault you like — for example, if you keep skills in a universal, agent-agnostic location:
```bash
python setup.py --skills-dir ~/.agents/skills --vault-dir ~/.my-vault
```
Explicit `--skills-dir` / `--vault-dir` override the `--agent` preset defaults.

**Options:**

| Flag | Description |
|---|---|
| `--agent {opencode,claude}` | Base preset providing default paths (default: `opencode`). |
| `--skills-dir PATH` | Active skills directory to reorganize (overrides the preset). |
| `--vault-dir PATH` | Hidden vault directory to move raw skills into (overrides the preset). |
| `-n`, `--dry-run` | Show what would happen without moving or writing anything. |
| `-f`, `--force` / `-y`, `--yes` | Skip the confirmation prompt before migrating. |
| `--no-color` | Disable colored output. |

> The migration **moves** your skill folders. Run with `--dry-run` first to preview the plan; the script confirms before making any changes unless you pass `--force`.

### Step 2: Test It!
Start your AI agent and ask it to fetch a specific skill:
> *"I want to create a CSS button. Please consult your `web-dev-category-pointer` first to find the exact best practice from your library before writing the code."*
Expand Down
Loading