Skip to content

feat(agent-config): share agent instructions and skills#17

Merged
jmeridth merged 3 commits into
mainfrom
shared-agent-config
Jun 5, 2026
Merged

feat(agent-config): share agent instructions and skills#17
jmeridth merged 3 commits into
mainfrom
shared-agent-config

Conversation

@jmeridth

@jmeridth jmeridth commented Jun 5, 2026

Copy link
Copy Markdown
Owner

What

Move global agent guidance into configs/AGENTS.md, keep CLAUDE.md as a symlink, and move shared and host-specific skills into agent-neutral configs/agents paths with Claude compatibility symlinks.

Why

Codex and Claude can share one editable instruction file and discover the same SKILL.md workflows through their own expected locations.

Notes

  • configs/claude/CLAUDE.md and configs/claude/skills are compatibility symlinks.
  • scripts/link-dotfiles.sh now links Codex guidance into ${CODEX_HOME:-$HOME/.codex}/AGENTS.md and shared skills into ~/.agents/skills.
  • This branch also includes the existing local chore: update pr-comments skill commit.

Testing

Dry-ran scripts/link-dotfiles.sh against /private/tmp/dotfiles-link-test-home with a fake hostname to verify Codex and skill symlinks are created without touching the real home directory.

jmeridth added 2 commits June 1, 2026 13:44
Signed-off-by: jmeridth <jmeridth@gmail.com>
## What

Move global agent guidance into configs/AGENTS.md, keep CLAUDE.md as a symlink, and move shared skills into configs/agents paths with Claude compatibility symlinks.

## Why

Codex and Claude can use one editable source for durable guidance and shared SKILL.md workflows while preserving each tool discovery paths.

## Notes

- link-dotfiles.sh links Codex guidance into CODEX_HOME or ~/.codex and shared skills into ~/.agents/skills.

- Host-specific skills now live under configs/{personal,work}/agents/skills.

- The existing review skill argument hint is carried forward with the move.

Signed-off-by: jmeridth <jmeridth@gmail.com>
@jmeridth jmeridth self-assigned this Jun 5, 2026
@github-actions github-actions Bot added the feature New feature label Jun 5, 2026
@github-actions github-actions Bot marked this pull request as ready for review June 5, 2026 22:44
## What

Link configs/agents directly to ~/.agents and remove the per-skill ~/.agents/skills linking loop.

## Why

The agents config should follow the same dotfiles ownership model as the rest of the linked tool directories.

## Notes

- Existing non-symlink ~/.agents directories are backed up before linking.

- link_file now removes wrong symlinks before recreating them.

Signed-off-by: jmeridth <jmeridth@gmail.com>
@jmeridth jmeridth marked this pull request as draft June 5, 2026 22:46
@github-actions github-actions Bot marked this pull request as ready for review June 5, 2026 22:47
@jmeridth jmeridth merged commit f120927 into main Jun 5, 2026
7 checks passed
@jmeridth jmeridth deleted the shared-agent-config branch June 5, 2026 22:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature New feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant