agentics

Shared configuration for AI coding agents, deployed via GNU Stow.

Agents

• Claude Code (~/.claude/) — settings, commands, Claude-only skills
• Codex (~/.codex/) — instructions, execution rules
• Shared (~/.agents/) — skills available to both agents

Structure

agentics/
├── claude/.claude/              # Stow package → ~/.claude/
│   ├── CLAUDE.md                # Global instructions
│   ├── settings.json            # Settings
│   ├── commands/                # Slash commands
│   └── skills/                  # Claude-only skills
├── codex/.codex/                # Stow package → ~/.codex/
│   ├── AGENTS.md                # Global instructions
│   └── rules/default.rules     # Execution policy
│   # config.toml is NOT stowed — machine-owned (path-specific trust levels)
├── agents/.agents/              # Stow package → ~/.agents/
│   └── skills/                  # Shared skills (linked into both agents)
│       ├── reflect/
│       └── smart-commit/
├── bin/agstat                # Status dashboard and skill linker
├── SETUP.md                     # Full install guide
└── CLAUDE.md                    # Repo-level instructions

Skills

Custom skills (this repo)

• smart-commit — conventional commits with intelligent staging
• reflect — end-of-session review and reflection

Web scraping & search

• firecrawl — scrape, search, crawl, and interact with web pages
• firecrawl-agent — autonomous structured data extraction to JSON

Browser automation

• agent-browser — browser automation CLI for AI agents
• playwright-cli — browser automation via Playwright

Frontend & React

• frontend-design — production-grade frontend interfaces
• next-best-practices — Next.js file conventions, RSC, data patterns
• vercel-composition-patterns — React composition patterns that scale
• vercel-react-best-practices — React/Next.js performance optimization
• web-design-guidelines — UI accessibility and UX audit

Knowledge & documentation

• find-docs — library documentation lookup via Context7

Other

• deploy-to-vercel — deploy apps to Vercel
• remotion-best-practices — video creation in React
• writing-clearly-and-concisely — Strunk's writing rules for prose

CLI tools

• ctx7 — up-to-date library documentation for agents
• firecrawl — web scraping and search
• agent-browser — browser automation
• playwright-cli — browser automation via Playwright
• vercel — deployment CLI

Quick start

git clone <repo-url> ~/agentics
cd ~/agentics
stow --no-folding claude
stow --no-folding codex
stow --no-folding agents
bin/agstat --link

See SETUP.md for the full install guide — CLI tools, community skills, and verification.

Status dashboard

bin/agstat          # check everything
bin/agstat --link   # create missing symlinks for shared skills

References

• Using GNU Stow to Manage Your Dotfiles