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 — mode detection + universal invariants
• skills/kickjs-skill/references/adopter.md — guidance when working in a KickJS app
• skills/kickjs-skill/references/contributor.md — guidance when working in the kickjs monorepo itself

How to install correctly

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:

# 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 for the full project overview.