Imported from ushironoko/dotfiles (AGENTS.md). Install upstream with npx skills add ushironoko/dotfiles. Copyright stays with the author.

Dotfiles repository guidance

Name: dotfiles
Author: ushironoko

This repository is a TypeScript/Bun dotfiles manager. It creates and removes symlinks, keeps timestamped backups, and merges MCP configuration without destroying unrelated user state.

Commands

bun install
bun test
bun run lint
bun run lint:sh
bun run tsc
bun run run-all
bun run src/index.ts install -d
bun run src/index.ts list --verbose

Use Bun because bun.lock is present. Do not start a development server.

Architecture

src/index.ts parses CLI commands with Gunshi.
src/commands/ coordinates operations.
src/core/ contains config, symlink, backup, MCP merge, and logproxy logic.
src/utils/ contains filesystem, path, command, and logging helpers.
dotfiles.config.ts is the typed mapping source of truth.
claude/.claude/ and codex/ are the versioned sources for the two agent harnesses. Home-directory files are installed as symlinks.

Preserve unrelated or machine-generated state in ~/.claude, ~/.codex, and ~/.agents. Never replace those directories wholesale; add selective child links. codex/config.toml is a live file with a clean filter, so portable settings belong there while machine-local absolute-path tables must remain unstaged/scrubbed.

Tests use real temporary directories rather than mocked filesystem calls. Keep new behavior covered at the narrowest relevant layer and clean temporary state.

{ "ocm": "1", "id": "ushironoko-dotfiles-dotfiles", "kind": "skill", "name": "dotfiles", "description": "This repository is a TypeScript/Bun dotfiles manager. It creates and removes symlinks, keeps timestamped backups, and merges MCP configuration without destroying unrelated user state.", "publisher": "ushironoko", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "This repository is a TypeScript/Bun dotfiles manager. It creates and removes symlinks, keeps timestamped backups, and merges MCP configuration without destroying unrelated user state." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/ushironoko/dotfiles", "path": "AGENTS.md", "ref": "60fb1245ea94ff659c1272dbc3810fbb5cdaf628", "url": "https://github.com/ushironoko/dotfiles/blob/60fb1245ea94ff659c1272dbc3810fbb5cdaf628/AGENTS.md", "key": "ushironoko/dotfiles/AGENTS.md" } }, "instructions": "# Dotfiles repository guidance\n\nThis repository is a TypeScript/Bun dotfiles manager. It creates and removes\nsymlinks, keeps timestamped backups, and merges MCP configuration without\ndestroying unrelated user state.\n\n## Commands\n\n```bash\nbun install\nbun test\nbun run lint\nbun run lint:sh\nbun run tsc\nbun run run-all\nbun run src/index.ts install -d\nbun run src/index.ts list --verbose\n```\n\nUse Bun because `bun.lock` is present. Do not start a development server.\n\n## Architecture\n\n- `src/index.ts` parses CLI commands with Gunshi.\n- `src/commands/` coordinates operations.\n- `src/core/` contains conf", "cost": { "context_tokens": 351 } }

dotfiles

About

Dotfiles repository guidance

Commands

Architecture

Use it

Manifest

Reviews