# Kickjs Skill

> Pointer file. The actual KickJS framework skill lives at skills/kickjs-skill/SKILL.md inside this repository. Use scripts/install.sh to install it into ~/.claude/skills/ — do NOT install this root file as a skill.

- Skill: `forinda/kickjs-skill` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add forinda/kickjs-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/forinda/kickjs-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: forinda (https://skillmd.com/u/forinda)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/forinda/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.