
ai-config
Shared skills, agents, workflows, and configuration for Claude Code and Codex
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up ai-config (git-clone project) into my current project. Found on https://claudeers.com/ai-config Repo: https://github.com/salexandr0s/ai-config Homepage/docs: — Detected install method: git-clone → git clone https://github.com/salexandr0s/ai-config Category: devtools. Platforms: cli, web. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
git clone https://github.com/salexandr0s/ai-config
// compatibility
| Platforms | cli, web |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | — |
| Pricing | open-source |
| Language | TypeScript |
ai-config
Shared skills and workflows for Claude Code and Codex.
A versioned setup for coding assistants: matching agent roles, reusable skills,
workflow prompts, hooks, and design standards. Personal state stays local.
Get started · Skill catalog · Configuration guide
78 bundled skills / 8 agent roles / 2 assistants
What it provides
| Part | Purpose |
|---|---|
| Skills | Design, writing, security, debugging, Apple platforms, deployment, and project maintenance |
| Agent roles | A matching eight-role roster for planning, implementation, review, and coordination |
| Workflows | Claude slash commands and installed Codex prompt templates for features, fixes, and reviews |
| Configuration | Shared defaults, response styles, hook wiring, and private local overlays |
| Design standards | Typed visual tokens, component specifications, and UI quality checks |
| Installer | Relocatable links, backups, config validation, and optional browser/LaunchAgent setup |
The skill catalog lists every binding, its assistant availability, source, and attribution. There are 46 Claude bindings and 74 Codex bindings; identical shared packages have one canonical source. Tool-specific adaptations remain separate.
Install
macOS-first. Requires Bash, Git, and Python 3.11+. Install Claude Code, Codex, or both separately. Node.js 18+ runs the bundled writing tools; the configured shadcn MCP integration also needs a compatible Node/npm installation on PATH. Bun is optional.
The supplied Codex base uses danger-full-access and approval policy never. Review runtime preferences before installing, and keep personal overrides in the private local configuration.
git clone https://github.com/salexandr0s/ai-config.git
cd ai-config
./install.sh
Managed tool-link replacements are backed up. Codex configuration is merged, validated, and regenerated; private overlays and personal context are preserved. The default setup links configuration, skills, commands, and workflows without building the browser daemon or starting a background job.
./install.sh --with-browse # Optional: build the browser daemon with Bun
./install.sh --with-launchagent # Optional: weekly memory rotation on macOS
To install workspace instructions somewhere other than an existing ~/GitHub, use ./install.sh --workspace "$HOME/Projects". See installation and configuration for file destinations, local overrides, and runtime preferences.
Use it
In Claude Code:
/workflow-feature add a settings page
/workflow-bugfix investigate a failed save
/workflow-review-only review the authentication module
In Codex CLI:
codex '$config-editor audit the current configuration'
codex "Follow $HOME/.codex/workflows/feature.md to implement a settings page"
Skill availability differs by assistant. The catalog includes writing with avoid-ai-writing, product demonstrations with Stageshow, security review with deepsec, and the complete platform/design/deployment inventory. The locally installed aside-browser skill is listed as external because its upstream bundle has no redistribution license; it is preserved locally and not vendored here.
How it's organized
| Directory | Owns |
|---|---|
shared/ | Canonical shared skills, workspace instructions, and assistant UX conventions |
claude/ | Claude agents, commands, skill bindings, settings, resources, and UI contracts |
codex/ | Codex agents, skill bindings, workflows, rules, styles, and base TOML |
scripts/ | Installation helpers, config rendering, inventory checks, and maintenance tools |
browse/ | Optional browser daemon source |
tests/ | Regression checks for hooks, configuration, installation, and skill packaging |
skills-manifest.json records skill provenance and package hashes. The generated catalog is checked against it, including relative aliases and required resources.
Private configuration
Shared defaults belong in this repository. Credentials, local settings, trusted project paths, personal identity files, memory, sessions, caches, and session journals stay outside Git.
| Public source | Private local counterpart |
|---|---|
claude/settings.json | ~/.claude/settings.local.json |
codex/config.base.toml | ~/.config/codex/config.local.toml |
Blank claude/user/ templates | ~/.claude/USER/ personal context |
Codex configuration is merged and validated before replacing the live file. Invalid local TOML leaves the previous config intact. See the privacy review for source boundaries and historical cleanup scope.
Verify and maintain
python3 scripts/skills-inventory.py --check
python3 scripts/skills-inventory.py --installed
python3 -B scripts/verify-avoid-ai-writing.py
python3 -B -m unittest discover -s tests -v
--installed reports differences without replacing local skills. After an intentional skill change, review the source and notices, then run python3 scripts/skills-inventory.py --refresh. Re-run the installer to refresh links; private overlays are retained.
Documentation
- Installation, local overlays, hooks, agents, and workflows
- Complete skill catalog and external integrations
- Privacy boundary and history review
- UI/UX design contract
- Shared writing skill and its verification tools
Third-party skills retain their own licenses and notices, recorded in their packages and the manifest. This repository does not apply one blanket license to those sources.
// faq
What is ai-config?
Shared skills, agents, workflows, and configuration for Claude Code and Codex. It is open-source on GitHub.
Is ai-config free to use?
ai-config is open-source, so it is free to use.
What category does ai-config belong to?
ai-config is listed under devtools in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/ai-config)
// retro hit counter
[](https://claudeers.com/ai-config)
// reviews
// guestbook
// related in Developer Tools
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…
Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA