Skip to content

Repository files navigation

agent-project-init

Initialize one shared repository-local skill source for Claude Code, Codex, and Pi.

.claude/skills/write-ai-doc/SKILL.md
.codex/skills -> ../.claude/skills
.pi/skills -> ../.claude/skills
docs-ai/README.md

The default is intentionally small: it includes write-ai-doc and does not include ip-as-logo.

Usage

Run this from the project root:

npx --yes github:SunChJ/agent-project-init

Or initialize an explicit directory:

npx --yes github:SunChJ/agent-project-init /path/to/project

Preview the operation without writing:

npx --yes github:SunChJ/agent-project-init --dry-run

For repeated use, install directly from GitHub:

npm install --global github:SunChJ/agent-project-init
agent-init /path/to/project

Safety model

  • Initialization is idempotent.
  • All structural conflicts are detected before any file is written.
  • Existing customized write-ai-doc and docs-ai/README.md files are preserved.
  • Existing .codex/skills or .pi/skills paths that are not the expected relative symbolic links are reported as conflicts and left untouched.
  • No global Claude, Codex, or Pi configuration is modified.

Requires Node.js 20 or later. Directory symbolic links must be supported by the host environment.

Development

npm install
npm run check
npm test

License

MIT

About

Initialize shared repository-local skills for Claude Code, Codex, and Pi.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages