A dotfiles repo that treats AI agent behavior as infrastructure.
Important
The contents of this repository, including skills, prompts, rules, documentation, code, and generated outputs, are likely AI-generated or AI-assisted (this note included 😄).
- Share AI that's too good to keep to myself.
- Update docs automatically so I don't have to.
- Make it easier to install and reuse skills.
- Show people how to actually use these things.
- Treat agent behavior like infrastructure.
- Keep it versioned, diffable, and deployable.
- Let naming conventions and file placement do the work of configuration.
Fork this repo and select it as your dotfiles repository in Codespaces settings. Add environment variables as Codespace secrets. Every new codespace runs script/bootstrap automatically.
Run the bootstrap script to install tools, configure agents, and wire up skill directories.
bash script/bootstrapBootstrap also sets AI-friendly defaults like GIT_PAGER=cat and NPM_CONFIG_LOGLEVEL=warn to suppress pagers and noisy output so agents can parse tool results cleanly.
An identity-engineering framework built around a meta mnemonic.
It keeps the persona model coherent, consistent, explainable, and easy to extend.
Fill the 5 slots (C/O/R/E/S):
- Context: Who this is
- Obstacle: Why this matters
- Routine: How this works
- Effect: What this does
- Scope: What this retains
The result is a reusable structure for defining and evolving personality modules.
Curiously, this aligns with the “personality spheres” concept from a certain puzzle game.
Set these to install and configure AI agents automatically.
OPENROUTER_API_KEY: Installs Cline globally and runs auth with the openrouter/auto model.
ANTHROPIC_API_KEY: Installs Claude Code globally. Pay-as-you-go via the Anthropic Console.
CLAUDE_CODE_OAUTH_REFRESH_TOKEN + CLAUDE_CODE_OAUTH_SCOPES Experimental: Installs Claude Code globally for subscription users. See Claude Code Authentication for GitHub Codespaces for setup.
In GitHub Codespaces, GITHUB_REPOSITORY is detected automatically to set the skills manifest path.
Generally skills follow the format: {subject…}-{predicate…}.
npx openskills install pbierkortte/ai-runbooknpx openskills updateSlash command:
/conventional-commitOr just ask naturally:
do a conventional commit/skillsEach tool file contains a specific prompt with instructions.
Runs on markdown and one bash script. Let docs tell agents what exists so you never hand-write instructions again.
An AGENTS.md at the repo root activates agent features in supported IDEs. It doubles as a table of contents agents read on first contact. It writes itself.
Rules live in RULES.md files scoped to the directory they apply to. Write them as headings and they surface into the index automatically. RULES.md follows its own rules and serves as the example.
One rule per line keeps each statement atomic so agents can follow it.
Scans markdown headings and regenerates every AGENTS.md it finds. Add an empty AGENTS.md to a directory and the docs there get noticed.
Bootstrap hooks collate into shell startup by appending a trigger to each RC file. It also sets BASH_ENV so non-interactive shells pick it up.
Run it manually with:
source script/agents-collate.shOne who wears many hats.
- Audio Transcription
- Audiovisual Transcription
- Checkpoint Comprehensive
- Checkpoint Distill
- The Cooperative Initiative
- Codebase Analysis
- continuous-improvement-initiative
- Filename Generator
- Lilypad Loop
- Slack Personality Self-Assessment
- Repo to Prompt
- Company Reconnaissance
- Cover Letter Checker
- Resume Cover Letter Coach
- Interview Chances
- Post-Interview Follow-Up Email Generator
- Interview Preparation Coach
- Job Recruitment Response Template
- Resume Proof Reading
- LinkedIn Proof Reader
- AntiSummary
- Chain of Thought Meta-Prompting
- Print Full Conversation
- Slack Communication Analyzer