dotagents

Reusable Codex skills, repo-local plugins, project maintainer skills, and MCP install helpers.

This repository is organized around two installable surfaces:

• Reusable skills under skills/, which can be linked locally or installed into Codex.
• Repo-local plugins under plugins/, which bundle related skills and shared runtime artifacts.

Project-only maintainer workflows live under .agents/skills/, and global MCP setup helpers live under mcps/.

Repository Layout

Path	Purpose
skills/	Reusable skills, each with a SKILL.md entrypoint and agents/openai.yaml metadata.
plugins/	Repo-local Codex plugins, each with .codex-plugin/plugin.json and optional bundled skills.
.agents/skills/	Project-local maintainer skills for working on this repository.
.agents/plugins/marketplace.json	Local plugin discovery surface for this checkout.
mcps/	Helpers for installing global Codex MCP server entries not bundled with Codex itself.
skills-link.sh	Local development helper that links reusable skills into ~/.agents/skills.

Repo-Local Plugins

Install repo-local plugins from this checkout through .agents/plugins/marketplace.json.

Plugin	Path	Purpose
GitStack	plugins/gitstack/	Bundles git commit authoring, git/gh-first GitHub workflows, focused CI/review helpers, release checks, and publish orchestration.
TanStack	plugins/tanstack/	Bundles TanStack Query, Router, Start, CLI, and cross-stack integration guidance through umbrella skills and focused sub-skills.

GitStack Skills

git-commit, github, github-triage, github-reviews, github-ci, github-releases, yeet.

plugins/gitstack/ expects both git and GitHub CLI gh on PATH before GitHub-backed commands run:

command -v git && git --version
command -v gh && gh --version

Use plugins/gitstack/skills/github/references/core/installation.md for cross-platform install guidance.

TanStack Skill Families

• Umbrellas: tanstack-query, tanstack-router, tanstack-start, tanstack-cli, tanstack-integration.
• Router: tanstack-router-core, tanstack-router-search-params, tanstack-router-path-params, tanstack-router-navigation, tanstack-router-data-loading, tanstack-router-auth-and-guards, tanstack-router-code-splitting, tanstack-router-not-found-and-errors, tanstack-router-type-safety, tanstack-router-ssr, tanstack-router-plugin.
• Start: tanstack-react-start, tanstack-react-start-server-components, tanstack-start-migrate-from-nextjs, tanstack-start-core, tanstack-start-execution-model, tanstack-start-middlewares, tanstack-start-server-functions, tanstack-start-server-routes, tanstack-start-deployments, tanstack-start-server-core.
• CLI: tanstack-cli-create-app-scaffold, tanstack-cli-add-addons-existing-app, tanstack-cli-choose-ecosystem-integrations, tanstack-cli-maintain-custom-addons-dev-watch, tanstack-cli-query-docs-library-metadata.

For linked git + GitHub workflows, install the GitStack plugin instead of looking for separate standalone git-commit, github, or yeet skills. For TanStack React application work, install the TanStack plugin instead of copying advice from mixed community sources.

Reusable Skills

Skill	Purpose
code-wiki	Explore a local repository or git URL, then generate an evidence-backed linked HTML code wiki.
skill-cli-creator	Build host-aware embedded CLIs that live inside a skill or plugin under scripts/.
codex-changelog	Check installed Codex CLI and Codex App versions, then print CLI and app changelog sections.
xcode-changelog	Resolve active Xcode notes, include latest notes when behind, look up a version, or list Apple Xcode release notes.
plan-harder	Create a higher-rigor implementation plan with focused clarification, a gotcha pass, and a saved plans/<topic>-plan.md.
grill-me	Stress-test plans, decisions, designs, drafts, strategies, workflows, and coding approaches before action.
learn	Capture durable corrections or preferences and write confirmed learnings only to AGENTS.md.
postgres	Connect to Postgres databases, run SQL and diagnostics, inspect schemas and migrations, and review query performance.
skill-audit	Audit installed Codex skills, plugin packages, and bundled plugin skills using evidence from repos, memory, sessions, and current context.
swift-api-design	Design or review Swift APIs using curated summaries and a bundled copy of the official Swift API Design Guidelines.
swift-docc	Write, structure, review, and publish Swift-DocC documentation using curated summaries and a bundled upstream DocC source tree.

Skill Dependencies

• code-wiki requires $imagegen when generating raster overview or conceptual images for a wiki.

Project-Local Skills

Skill	Path	Purpose
Maintainer	.agents/skills/Maintainer/	Maintain and improve one or more skills or plugins in this repository with shared upgrade workflows and skill-specific refresh tasks.

Project-local skills are repository-specific and are not included in reusable install commands.

Installation

Use Repo-Local Plugins

Repo-local plugins are exposed through .agents/plugins/marketplace.json; they are not installed by skills-link.sh.

• Use GitStack for linked git + GitHub workflows.
• Use TanStack for TanStack Query, Router, Start, CLI, and integration work.

Link Reusable Skills For Local Development

Run this from the repository root to link skills/ into ~/.agents/skills:

./skills-link.sh

This helper only links reusable skills. It does not install, mirror, or rewrite plugin marketplace entries.

Install Reusable Skills With skill-installer (Codex-only)

Inside Codex, install all reusable skills with:

Use $skill-installer to install skills from alemar11/dotagents --path skills/code-wiki skills/skill-cli-creator skills/codex-changelog skills/xcode-changelog skills/plan-harder skills/grill-me skills/learn skills/postgres skills/skill-audit skills/swift-api-design skills/swift-docc

Install one reusable skill by passing only its path:

Use $skill-installer to install skills from alemar11/dotagents --path skills/code-wiki

Replace skills/code-wiki with any path listed in the reusable skills table.

Install Reusable Skills With npx skills

These commands use the vercel-labs/skills CLI and target Codex directly.

List the skills available in this repository:

npx skills add alemar11/dotagents --list

Install all reusable skills globally for Codex:

npx skills add alemar11/dotagents -a codex -g -y \
  --skill code-wiki \
  --skill skill-cli-creator \
  --skill codex-changelog \
  --skill xcode-changelog \
  --skill plan-harder \
  --skill grill-me \
  --skill learn \
  --skill postgres \
  --skill skill-audit \
  --skill swift-api-design \
  --skill swift-docc

Install one reusable skill globally for Codex:

npx skills add alemar11/dotagents -a codex -g -y --skill code-wiki

Replace code-wiki with any skill name from the reusable skills table. Omit -g to install into the current project's .agents/skills/ instead of your global ~/.codex/skills/.

Restart Codex after installing or updating skills.