kickjs-skill

# Repository entry point — not the actual skill This file exists at the repository root so the package layout is discoverable on GitHub, but **it is not the skill Claude should load**. The real skill lives at: - [`skills/kickjs-skill/SKILL.md`](./skills/kickjs-skill/SKILL.md) — mode detection + universal invariants - [`skills/kickjs-skill/references/adopter.md`](./skills/kickjs-skill/references/adopter.md) — guidance when working in a KickJS app - [`skills/kickjs-skill/references/contributor.md`](./skills/kickjs-skill/references/contributor.md) — guidance when working in the kickjs monorepo itself ## How to install correctly ```bash git clone https://github.com/forinda/kickjs-skill ~/dev/kickjs-framework-skill ~/dev/kickjs-framework-skill/scripts/install.sh ``` The install script symlinks `skills/kickjs-skill/` (NOT this repository root) into `~/.claude/skills/kickjs-skill/`. That's the directory Claude actually loads. ## If you reached this via Claude You probably installed by cloning the repo directly into `~/.claude/skills/` instead of running `scripts/install.sh`. To fix: ```bash # Remove the incorrect install rm -rf ~/.claude/skills/kickjs-framework-skill # Re-install using the script ~/dev/kickjs-framework-skill/scripts/install.sh ``` Then restart your Claude Code session. The skill that activates will be `kickjs-skill`, loaded from `skills/kickjs-skill/SKILL.md`. ## Why this file exists GitHub readers expect to see the project structure from the root. A repository called `kickjs-framework-skill` with no top-level `SKILL.md` is confusing for someone landing on the repo. This file gives them a clear pointer to the actual skill location and the install workflow. See [`README.md`](./README.md) for the full project overview.