https://github.com/luabagg/agent-skills
https://github.com/luabagg/agent-skills
Last synced: 28 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/luabagg/agent-skills
- Owner: luabagg
- Created: 2026-04-23T02:19:13.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-06-26T22:10:56.000Z (28 days ago)
- Last Synced: 2026-06-27T00:29:29.755Z (28 days ago)
- Language: JavaScript
- Size: 119 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Personal Agent Skills
Public source of truth for my global agent instructions, personal skills, curated third-party skill references, and non-skill tool references.
This repo supports:
- Claude Code
- Codex
- Copilot
- OpenCode
## Layout
```text
.
|-- AGENTS.md # Repo-scoped instructions for working in this repo
|-- AGENTS.global.md # Global agent instructions, distributed to ~/.codex, ~/.claude, etc.
|-- CLAUDE.md -> AGENTS.md # Symlink so Claude loads repo-scoped rules in this repo
|-- skills/ # Personal skills authored here
|-- curated-skills.json # Installable skill sources plus reference-only plugin inventory
|-- curated-tools.json # Non-skill tools, CLIs, packages, and docs I use
|-- harnesses/ # Opt-in harness-specific setup manifests
|-- scripts/ # Install helpers
|-- package.json # Small npm command surface
`-- README.md
```
## Install
Install package dependencies from a local checkout:
```bash
npm install
```
Install global skills and instructions:
```bash
npm run setup
```
Default mode uses symlinks where the target tool supports normal files. Use copy mode when symlinks are not desirable:
```bash
npm run setup:copy
```
What `npm run setup` does:
- Installs personal skills from `skills/` for `claude-code`, `codex`, `github-copilot`, and `opencode` using `npx skills`.
- Installs curated third-party skills from `curated-skills.json` `sources`.
- Installs global `AGENTS.global.md` guidance for Claude, Codex, Copilot, and OpenCode.
## Commands
```bash
npm run skills:list # list personal skills in this repo
npm run install:skills # install only personal skills
npm run install:curated # install only curated skills-cli sources
npm run install:curated:dry-run # preview curated skill install commands
npm run install:agents # install only global AGENTS.global.md guidance
npm run setup # full symlink setup
npm run setup:copy # full copy setup
npm run setup:memory-palace # persist the default memory-palace vault path
npm run setup:opencode # opt-in OpenCode harness setup
npm run setup:opencode:dry-run # preview OpenCode harness setup
npm run verify # non-destructive verification pass
```
## Personal Skills
Personal skills live in `skills//SKILL.md`.
Current personal skills:
| Skill | Purpose |
| --- | --- |
| `branch-port` | Port a feature across heavily diverged branches without unsafe merges |
| `memory-palace` | Ingest, query, and lint the personal Obsidian knowledge vault |
| `thorough-pr-review` | Review PRs and branches for correctness, reliability, and merge-readiness |
List local personal skills:
```bash
npm run skills:list
```
### Memory Palace Vault Path
Configure the default vault path once so the `memory-palace` skill works from any current directory:
```bash
npm run setup:memory-palace -- --vault /mnt/c/Users//Documents/
```
If you are running from WSL and your vault lives on Windows, paste the Windows path from Explorer:
```bash
npm run setup:memory-palace -- --vault "C:\Users\user-name\Documents\Obsidian Vaults\obsidian-vault"
```
The setup script converts it to a WSL-accessible path before saving it.
The setting is saved at `~/.agents/memory-palace/config.json`:
```json
{
"vaultPath": "/mnt/c/Users//Documents/",
"configuredAt": "2026-06-15T00:00:00.000Z",
"sourceInput": "C:\\Users\\\\Documents\\"
}
```
Resolution precedence inside the skill is:
1. explicit vault path in the current user request
2. `MEMORY_PALACE_VAULT`
3. `~/.agents/memory-palace/config.json`
4. current-directory detection as a fallback
On WSL, Windows paths like `C:\Users\...` are expected and are converted to `/mnt/c/Users/...` before validation and saving. The saved path must already be accessible from WSL.
## Curated References
`curated-skills.json` tracks two different inventories:
- `sources` are third-party skill sources installable by `npx skills`. `npm run install:curated` only uses this list.
- `pluginReferences` are plugin-style or harness-specific skill references. They are tracked for awareness only and are not installed by `npm run setup` or `npm run install:curated`.
Harness-specific setup stays separate from the default setup flow unless explicitly added later.
`curated-tools.json` tracks non-skill tools, CLIs, packages, and docs I use. It is a reference catalog only; it does not drive installation.
## Harness-Specific Setup
Harness-specific setup is opt-in and separate from `npm run setup`.
OpenCode setup is tracked in `harnesses/opencode.json` and exposed through:
```bash
npm run setup:opencode:dry-run
npm run setup:opencode
```
The OpenCode setup script validates the manifest, prints manual installer commands for broad tools such as OMO / oh-my-openagent, and only mutates OpenCode config for explicitly selected plugin entries. It does not run third-party plugin installers automatically.
Use `-- --enable-recommended` when you want recommended `opencode-plugin` entries added to OpenCode config:
```bash
npm run setup:opencode:dry-run -- --enable-recommended
npm run setup:opencode -- --enable-recommended
```
## Global Instructions
`AGENTS.global.md` is the source of truth for global agent behavior. `npm run install:agents` distributes it to:
- Codex: `~/.codex/AGENTS.md`
- Claude: `~/.claude/AGENTS.md` plus `~/.claude/CLAUDE.md` importing `@AGENTS.md`
- Copilot: `~/.copilot/AGENTS.md` plus `~/.copilot/instructions/global-agent.instructions.md`
- OpenCode: `~/.config/opencode/AGENTS.md` plus a global config `instructions` entry
Default mode symlinks those targets back to this repo. `npm run setup:copy` copies file contents instead.
`AGENTS.md` is repo-scoped and only applies when working inside this repository. opencode and Codex pick it up natively via the project `AGENTS.md`; Claude picks it up via the repo-root `CLAUDE.md` symlink -> `AGENTS.md`.
After changing OpenCode config, restart OpenCode. Running sessions keep using already-loaded config.
## Verify
Run the non-destructive repo checks:
```bash
npm run verify
```
Optional runtime checks:
```bash
codex --ask-for-approval never "Summarize current instructions."
```
For OpenCode, inspect `~/.config/opencode/opencode.jsonc` and confirm the `instructions` array includes `~/.config/opencode/AGENTS.md`.
## Safety
This repository is public. Do not add private dashboards, tokens, org IDs, internal URLs, API keys, or generated local memory context.