AI Skills

By placing a SKILL.md file in your project, you can communicate Lism CSS design rules, Props, tokens, and naming conventions to AI agents.

There are three skills available:

Skill	Purpose
`lism-css-guide`	Design rules, Props, tokens, and naming conventions for new implementations (design/requirements → code)
`lism-css-refactor`	Refactors existing Lism CSS code to follow Lism CSS design rules without changing its appearance or behavior
`lism-mockup-guide`	Workflow and data hand-off format for building mockups with `@lism-css/mockup` (requires `lism-css-guide` alongside)

GitHub: core/skills/lism-css-guide/ / core/skills/lism-css-refactor/ / core/skills/lism-mockup-guide/

Setup

Via skills.sh

With skills.sh, you can easily fetch a skill using the following command:

npx skills add lism-css/core

pnpm dlx skills add lism-css/core

yarn dlx skills add lism-css/core

bunx skills add lism-css/core

Via gh command

If you use the GitHub CLI, you can also fetch a skill with gh skill install:

gh skill install lism-css/core lism-css-guide@main
gh skill install lism-css/core lism-css-refactor@main
gh skill install lism-css/core lism-mockup-guide@main

Via lism-cli

You can also fetch the same skills with lism-cli skill add. It only supports installing into the project directory, but it offers the skill check command to compare the skills on GitHub with your local files. Running it without arguments targets all three skills above (lism-css-guide / lism-css-refactor / lism-mockup-guide).

npx lism-cli skill add

pnpm dlx lism-cli skill add

yarn dlx lism-cli skill add

bunx lism-cli skill add

In interactive mode, the CLI detects each tool’s project-root directories and files (.claude/, .cursor/, etc.) and pre-checks matching destinations. To target tools non-interactively, pass the flags directly:

# Install into a single tool (defaults to all three skills when the skill name is omitted)
npx lism-cli skill add --claude

# Multiple tools at once
npx lism-cli skill add --claude --cursor

# All tools
npx lism-cli skill add --all

# Install a specific skill by name
npx lism-cli skill add lism-css-refactor --claude

Destinations

Destinations shown here use lism-css-guide as an example. For the other skills, only the directory name changes (e.g. .claude/skills/lism-css-refactor).

Flag	Destination
`--claude`	`.claude/skills/lism-css-guide`
`--codex`	`.agents/skills/lism-css-guide`
`--cursor`	`.cursor/skills/lism-css-guide`
`--windsurf`	`.windsurf/skills/lism-css-guide`
`--cline`	`.cline/skills/lism-css-guide`
`--copilot`	`.github/skills/lism-css-guide`
`--gemini`	`.gemini/skills/lism-css-guide`
`--junie`	`.junie/skills/lism-css-guide`

Update

You can diff your local files against the skills on GitHub before updating.

# Diff the skills on GitHub against local files (shows changed / added / removed summary)
npx lism-cli skill check

# Overwrite with the latest version
npx lism-cli skill update --claude

skill check compares each installed file by sha256, then lists the changed / added / removed files. To see the latest changes, check the GitHub repository directly.