Skip to content

urmzd/dotfiles / dot_agents/skills/configure-ai

configure-ai

Verified

Authors AGENTS.md and defines the skills-vs-docs boundary for a repo. Configures AI coding tools (Claude Code, Codex, Antigravity CLI, Copilot) and the skills-as-docs philosophy. Use when creating or auditing AGENTS.md, setting up AI tooling for a project, or deciding what belongs in a skill versus docs/. Do NOT use for README structure -> use write-readme; for llms.txt generation -> use create-llms-txt; for Claude-specific skill features (invocation control, subagents, model overrides) -> use extend-oss-skills-to-claude.

AI Workflows

Specifications

ConventionSpec
SKILL.mdAgent Skills Specification
AGENTS.mdagents.md Standard
llms.txtllms.txt Specification

Skills vs Docs

  • Skills (skills/<name>/SKILL.md) = executable agent instructions. How to do things (conventions, workflows, tool usage)
  • Docs (docs/) = project documentation. What was decided and why (layout owned by scaffold-docs)
  • Both exist in every project; neither replaces the other
  • Every repo should also have: README.md (humans) + AGENTS.md (AI) + llms.txt (LLM discovery)
  • Root-level standard files stay at root; everything else goes in docs/ (allowlist in scaffold-docs)

AI Tools

ToolUsage
Claude Code (opus)Primary AI coding assistant. Architecture, refactoring, multi-file edits
OpenAI Codexworkspace-write "Auto" base config with a guardian auto-reviewer; ships writer, reviewer, plan, and guardian profiles/agents
Google Antigravity CLI (agy)Replaces legacy Gemini CLI; per-command allow/deny lists managed in-app via /permissions, --sandbox for terminal restrictions
GitHub CopilotInline completion plus settings.json (model, reasoning effort, theme)

Claude Code Configuration

Claude Code is configured per-project via CLAUDE.md files at the repository root. These files define:

  • Project context tech stack, directory structure, key patterns
  • Coding conventions naming, formatting, commit style
  • Behavioral rules what to avoid, how to handle edge cases
  • Memory persistent notes stored in .claude/ directories

Best Practices

  • Keep CLAUDE.md concise; it's loaded into every conversation
  • Use separate memory files for detailed topic notes
  • Reference project-specific tools and commands
  • Define verification steps (build, test, lint)

AGENTS.md Standard

Every repo MUST have AGENTS.md at root.

Template Structure

  1. Identity project name, one-line description
  2. Architecture high-level component overview
  3. Commands build, test, lint, run
  4. Code Style language-specific conventions
  5. Extension Guide how to add features

Do NOT include static directory trees or file tables; structure goes stale. Instead, instruct agents to use tree and ripgrep/ag to discover project layout on the fly.

Skills Standard

Every repo with a CLI or library should have skills/<name>/SKILL.md:

  • Frontmatter: name, description, argument-hint (for CLI tools)
  • Content: step-by-step guidance for using or extending the project
  • Skills live in skills/<name>/SKILL.md within each repo

Git Workflows

AI-assisted commit, review, and PR authoring live in dedicated agent skills (ship, pr, review), not in the release tool. The release tool (sr) is release-engineering only as of v7: release, status, config, init, migrate, completions, update. See sync-release for release conventions and sr migrate for the upgrade guide from older versions.

rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall