connect-project

Migrates project CLAUDE.md files into a private claude-rules repository and replaces them with symlinks.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/lfuuu/claude-rules --skill connect-project-lfuuu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: connect-project
Source: https://github.com/lfuuu/claude-rules/tree/main/.claude/skills/connect-project
Command: npx skills add https://github.com/lfuuu/claude-rules --skill connect-project-lfuuu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping CLAUDE.md configuration files inside project repositories exposes private agent instructions and duplicates them across projects. This Skill moves a project's CLAUDE.md (and optional .claude/skills directory) into a centralized private claude-rules repository and replaces the originals with relative symlinks, so projects stay clean while configuration remains versioned in one place. ## Core Features & Use Cases - CLAUDE.md Migration: Copies an existing CLAUDE.md into claude-rules, deletes the original, and creates a relative symlink in the project directory. - Git Hygiene: Adds CLAUDE.md to the project's .gitignore and runs git rm --cached if the file is tracked, preventing accidental commits. - Skills and Bootstrap Handling: Migrates .claude/skills directories when present, generates a minimal CLAUDE.md template when none exists, and registers the project in setup-symlinks.sh for restoration. - Use Case: You start a new project in ~/projects and want its agent instructions stored privately. Run the skill with the project name and it performs the full migration, symlink setup, and verification in one pass. ## Quick Start Ask the agent to connect the current project to claude-rules by running the connect-project skill with the project name as the argument.

Frequently Asked Questions about connect-project

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I move CLAUDE.md out of a project repository?

Run the connect-project skill with the project name. It copies CLAUDE.md into the claude-rules directory, deletes the original, adds it to .gitignore, and creates a relative symlink so the file still resolves in the project.

How to keep Claude Code config files private across projects?

Store them in a separate private repository and symlink them into each project. This skill automates that pattern for CLAUDE.md and .claude/skills, and registers each project in setup-symlinks.sh for easy restoration.

What happens if the project has no CLAUDE.md file?

The skill creates a minimal CLAUDE.md template in claude-rules with critical sections covering language, git commit and push rules, branching, and formatting, plus a project description section, then symlinks it into the project.

Does the skill handle CLAUDE.md files already tracked by git?

Yes. If CLAUDE.md is tracked, the skill runs git rm --cached CLAUDE.md to untrack it while keeping the symlink on disk, and adds the filename to the project's .gitignore.

Can it migrate .claude/skills directories too?

Yes. If .claude/skills exists and is not already a symlink, the skill copies it into the claude-rules project directory, removes the original, and creates a symlink pointing to the new location.