AI Agent Assets

Reusable assets for AI agents: shared instructions, agent profiles, prompts, and tool-integrated skills. This repo also ships Home Manager customizations for OpenCode and Pi Coding Agent on Nix-based setups.

• global-instructions.md: shared cross-agent rules and guidance
• agents/: agent profiles and behavior guidance
• prompts/: reusable command prompt templates
• skills/: local skills with docs and helper scripts
• nix/opencode.nix: OpenCode Home Manager module export
• nix/pi-coding-agent.nix: Pi Coding Agent Home Manager customizations

If you use OpenCode with Home Manager, this repository exports homeManagerModules.opencode.

Add this repo as a flake input:

inputs.ai.url = "github:adampoit/ai";

Enable the module in Home Manager:

home-manager.sharedModules = [
  inputs.ai.homeManagerModules.opencode
];

If you use Pi Coding Agent with Home Manager, this repository exports homeManagerModules.pi-coding-agent. It configures Home Manager's upstream programs.pi-coding-agent module, installs a pinned Pi package, shared prompts, skills, extensions, a gruvbox theme, and formatter/LSP helper packages.

Enable the module in Home Manager:

home-manager.sharedModules = [
  inputs.ai.homeManagerModules.pi-coding-agent
];

The module uses the Pi package pinned and tested in this repository so runtime and extension updates remain synchronized. Customize models with the upstream module setting:

programs.pi-coding-agent.settings.enabledModels = [
  "github-copilot/claude-opus-4.6"
  "openai-codex/gpt-5.5"
];

• opencode on PATH (only needed when using the OpenCode module/CLI)
• Any model-provider credentials needed by Pi/OpenCode
• .NET SDK (required by C#-based skills)
• Any tool-specific credentials needed by individual skills (for example, SLACK_API_TOKEN for Slack)

For module-related edits, validate syntax with:

nix flake show
nix-instantiate --parse ./nix/opencode.nix
nix-instantiate --parse ./nix/pi-coding-agent.nix

For Pi TypeScript extension edits, run typechecking and tests from the dev shell so the expected language servers are available:

nix develop -c npm ci
nix develop -c npm run typecheck
nix develop -c npm test
nix flake check

The four Pi npm development dependencies must match the version in nix/pi-coding-agent-source.nix; nix flake check enforces this and builds the pinned runtime package.

The scheduled update-pi GitHub Actions workflow uses nix-update to update the runtime source and dependency hashes, synchronizes the four npm development dependencies, validates the result, and opens a pull request. It can also be run manually with an explicit version from the Actions UI.

MIT