Prompt Master Skill

Personal Dotfiles

Domain-driven Neovim and Windows Terminal configuration focused on reproducible workflows across macOS and Windows.

Features

• Modular Neovim Architecture: lazy.nvim loads plugins by domain (AI, completion, LSP, UI, Git) for predictable startup and maintenance.
• Smart Editing Defaults: Custom keymaps, Treesitter, Conform formatting, and Blink completion tuned to coexist with GitHub Copilot.
• Custom Dark Theme: Hand-crafted colorscheme with Nerd Font icons, mini.statusline, Neo-tree, and Telescope integrations.
• Integrated Developer Tooling: Mason auto-installs Pyright and TypeScript LS, while Neogit, Gitsigns, and diagnostics bindings streamline Git and LSP tasks.
• PowerShell Session Intelligence: Oh My Posh prompt, PSReadLine tweaks, and tab-aware directory persistence designed for Windows Terminal.

Quick Start

Prerequisites

• Neovim 0.12+ with clipboard support and Git available in PATH (required by the rewritten nvim-treesitter on the main branch)
• tree-sitter CLI 0.26+ — required at runtime to compile parsers; nvim-treesitter no longer bundles it
• C compiler on PATH (Xcode Command Line Tools on macOS: xcode-select --install; build-essential on Linux; MSVC Build Tools on Windows) — used by tree-sitter to build parsers
• Node.js 18+ (required for GitHub Copilot and TypeScript tooling)
• PowerShell 7+ and Windows Terminal 1.18+ on Windows
• oh-my-posh, posh-git, DockerCompletion, Get-ChildItemColor, PSReadLine modules installed
• JetBrainsMono Nerd Font (or any Nerd Font 3.2+) selected in your terminal

Install the tree-sitter CLI

# macOS (Homebrew)
brew install tree-sitter-cli

# Linux / generic (requires npm)
npm install -g tree-sitter-cli

# Alternative: cargo
cargo install tree-sitter-cli

Verify with tree-sitter --version — nvim's :checkhealth nvim-treesitter must report it as ✅ before parsers will compile.

Installation

git clone [email protected]:rafaeelricco/dotfiles.git
cd dotfiles

Link Configuration

# macOS / Linux
ln -s "$(pwd)/nvim/init.lua" "$HOME/.config/nvim/init.lua"
ln -s "$(pwd)/nvim/lua" "$HOME/.config/nvim/lua"

# Optional: keep lazy.nvim lock file in sync if you generate one
# ln -s "$(pwd)/nvim/lazy-lock.json" "$HOME/.config/nvim/lazy-lock.json"

Claude Code Skills

Link the versioned skills directory so Claude Code resolves it via ~/.claude/skills:

# macOS / Linux
mkdir -p "$HOME/.claude"
ln -s "$(pwd)/.claude/skills" "$HOME/.claude/skills"

On Windows, double-click scripts/windows/setup-claude-skills.bat (or right-click → "Run as administrator"). It self-elevates via UAC and creates the symlink. If ~/.claude/skills already exists as a non-empty real directory, the script aborts so you can move its contents into ./.claude/skills/ first.

Claude Code Skill Marketplace

The repo also publishes each .claude/skills/<skill> as an individual Claude Code plugin. Add the marketplace once:

claude plugin marketplace add rafaeelricco/dotfiles

Then install only the skills you want:

claude plugin install create-pr@ricco-skills
claude plugin install code-pattern@ricco-skills
claude plugin install prompt-master@ricco-skills
claude plugin install gh-issue-drafter@ricco-skills

To install several skills, run one install command per skill. After pulling marketplace updates, refresh the catalog:

claude plugin marketplace update ricco-skills

Marketplace plugin files under plugins/ are generated from .claude/skills/. Regenerate them after editing skills:

python3 scripts/sync-claude-plugin-marketplace.py

After editing a skill:

1. Edit .claude/skills/<skill>/...
2. Run python3 scripts/sync-claude-plugin-marketplace.py
3. Commit and push .claude/skills/, plugins/, and .claude-plugin/
4. Ask teammates to refresh and update:

claude plugin marketplace update ricco-skills
claude plugin update <skill>@ricco-skills

Claude Code plugins do not load CLAUDE.md as global context. To install the global Claude instructions by command, copy them to ~/.claude/CLAUDE.md with an automatic backup:

curl -fsSL https://raw.githubusercontent.com/rafaeelricco/dotfiles/main/scripts/install-claude-md.py | python3

From a local clone, run:

python3 scripts/install-claude-md.py

Codex Skills

Reuse the same .claude/skills/ directory in the Codex CLI. Codex stores user skills under ~/.codex/skills/, but its bundled skills live in ~/.codex/skills/.system/, so we link per skill instead of the whole directory:

# macOS / Linux
mkdir -p "$HOME/.codex/skills"
for dir in .claude/skills/*/; do
  name=$(basename "$dir")
  ln -sfn "$(pwd)/$dir" "$HOME/.codex/skills/$name"
done