[FEATURE] .claude/skills/ and project config should be discovered without requiring a git repository

Resolved 💬 3 comments Opened Mar 27, 2026 by joejackson1993 Closed Apr 27, 2026

Preflight Checklist

  • [x] I have searched existing requests and this feature hasn't been requested yet
  • [x] This is a single feature request (not multiple features)

Problem Statement

Project-level skills in .claude/skills/ are not discovered when the working directory is not a git repository. Claude Code requires a .git/ directory to treat .claude/ as project configuration.

I distribute a n MCP project as a zip file that includes .claude/skills/ with custom skills and a CLAUDE.md. When users extract the zip and run claude, the skills are not discovered because there's no .git/ directory.

The current workaround is telling users to run git init first, but this is friction that shouldn't be necessary — the presence of .claude/ should be sufficient to discover project configuration.

Proposed Solution

Claude Code should discover .claude/skills/, .claude/commands/, and project CLAUDE.md based on the presence of the .claude/ directory itself, without requiring the directory to be a git repository.

Alternative Solutions

_No response_

Priority

Medium - Would be very helpful

Feature Category

Configuration and settings

Use Case Example

A team maintains an internal CLI toolkit distributed as a zip to new engineers during
onboarding. The zip includes:

my-toolkit/
├── .claude/
│ ├── skills/
│ │ └── deploy.md # guided deployment workflow
│ │ └── oncall-triage.md # runbook for investigating alerts
│ └── commands/
│ └── setup.md # interactive environment setup
├── CLAUDE.md # project conventions and tool usage
├── scripts/
└── configs/

The skills encode institutional knowledge — how to deploy safely, how to triage pages, how to set up a
dev environment. Today, none of this is discovered when a new engineer extracts the zip and runs claude.
They have to know to run git init first, which defeats the purpose of packaging everything up to "just
work."

This pattern applies broadly to any project distributed outside of git: vendor SDKs with Claude
integration, workshop/training materials, exported project archives, or air-gapped environments where git
isn't available.

Additional Context

_No response_

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗