lair

neithhogg's AI project foundation — install once, carry everywhere.

npx skills add neithhogg/lair

What it does

lair installs two things into any AI-assisted project:

Skills you invoke deliberately

Command	What it does
/project-init	Multi-phase conversation to bootstrap a new project — requirement discovery, scope lock, tech stack decision, file scaffold, skill installation
/project-sync	Keep all project docs accurate and consistent; JOURNAL.md is a living checklist
/project-config	Detect your AI agent environment and generate the right context file (CLAUDE.md, AGENTS.md, GEMINI.md, or .cursorrules)

Quick start

# 1. New project
mkdir my-project && cd my-project
npx skills add neithhogg/lair

# 2. Open Claude Code, then:
/project-init

How it works

project-init runs a four-phase conversation:

1. Discovery — clarify what you're building over multiple turns
2. Tech stack — propose a minimal stack with explicit tradeoffs
3. Scaffold — generate PROJECT.md, JOURNAL.md, .gitignore, tmp/
4. Skills — search skills.sh for your stack, multi-select install

project-sync keeps PROJECT.md current and JOURNAL.md as a living checklist — together they give any AI agent full project context across sessions.

Contributing / Setup

After cloning:

npm run setup

Installs all of lair's skills plus the team's recommended third-party skills into every AI tool you have installed (Claude Code, Cursor, Codex, Gemini CLI, etc.).

To add a recommended skill for the team, edit scripts/skills.recommended.json and open a PR.

Skill quality

Before merging changes to a user-invocable skill (project-init, project-sync):

1. Open Claude Code in this repo
2. Run /skill-creator and point it at the skill
3. Let it evaluate trigger accuracy and generate evals
4. Check in the resulting skills/{name}/evals/ files with your PR

Iterating lair itself

git clone https://github.com/neithhogg/lair && cd lair
# Make changes to skills/ or scripts/
git add . && git commit -m "skill: add [name]"
git push
# Other projects update with:
npx skills update

Stack coverage

TypeScript · React · Next.js · Go · Rust

License

MIT