msetsma

.Dotfiles Agents — Development skill for Claude Code

Development community

Catalog-driven config that syncs MCP servers, skills, plugins, hooks, and instructions into coding agents (opencode, Claude Code, Claude Desktop, Codex).

How to install .Dotfiles Agents

This entry records only its repository, not the path inside it, so there is no exact command to give. Open msetsma/.dotfiles-agents and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What .Dotfiles Agents does

Catalog-driven config that syncs MCP servers, skills, plugins, hooks, and instructions into coding agents (opencode, Claude Code, Claude Desktop, Codex).

Alternatives in Development

Codemcp — Coding assistant MCP for Claude Desktop 1.6k ★
Claude Code Everything You Need To Know — Ultimate all-in-one guide to mastering Claude Code 1.3k ★
MCP Linker — mcp store manager, add & syncs MCP server configurations across clients like Claude code, Cursor💡mcphub 308 ★

README

Agent configs: MCP servers, skills, plugins, hooks & instructions

[![License: Apache-2.0](https://img.shields.io/github/license/msetsma/.dotfiles-agents?style=flat-square)](https://github.com/msetsma/.dotfiles-agents/blob/main/LICENSE) [![Last commit](https://img.shields.io/github/last-commit/msetsma/.dotfiles-agents?style=flat-square)](https://github.com/msetsma/.dotfiles-agents/commits/main)

A catalog-driven config for coding agents. MCP servers (custom and third-party), skills, plugins, hooks, and per-tool instructions are declared once in [`catalog/`](catalog/) and synced into each agent by one command.

Usage

git clone git@github.com:msetsma/.dotfiles-agents.git
cd .dotfiles-agents

make              # list targets (same as `make help`)
make agent-check  # dry-run
make sync         # render + merge into every agent

Layout

.dotfiles-agents/
├── catalog/                # single source of truth — one file per resource
│   ├── mcp/*.toml          # MCP servers (custom + third-party)
│   ├── skills/.toml  # skills (content in /SKILL.md)
│   ├── plugins/.toml # opencode plugins (content in .ts)
│   ├── hooks/.toml   # Claude Code / Codex event hooks
│   ├── instructions/*.toml # per-tool prompts (content in .md)
│   ├── clients.toml        # where each agent keeps each kind
│   ├── paths.toml          # machine paths + ${VARS}
│   └── retired.toml        # resources to scrub from every client
├── bin/                    # agent-sync, agent-update, clean-python
└── mcp/                    # MCP server projects
    ├── m365-local-mcp/     # custom
    ├── teams-mcp/          # custom
    ├── databricks-mcp/     # pins ai-dev-kit's MCP from git
    └── entra-mcp/          # custom; also ships the `entra` CLI

How it works

flowchart LR
  C[catalog/] --> S[bin/agent-sync]
  S -- merge --> M[MCP + hooks in shared client configs]
  S -- symlink --> P[skills/ and plugins/ dirs]
  S -- bloc