Installation

Installation

Install the complete folders or use the release archives. Copying only SKILL.md leaves out the references and helper scripts that the skill needs.

Clone the repository

git clone https://github.com/wpgaurav/generateblocks-skills.git
cd generateblocks-skills
bash install.sh --help

Use git checkout v2026.09.18 for the documented release snapshot. Stay on main if you intentionally want subsequent repository changes. A checkout at a tag is detached; switch back with git switch main before pulling main-branch updates.

Claude Code and Cursor

From the repository directory:

bash install.sh claude

For Cursor, use bash install.sh cursor. You can select both with bash install.sh claude cursor.

These options copy all four skill folders into ~/.claude/skills/ or ~/.cursor/skills/. Existing files at those destinations are updated. Preserve any local customizations before installing over them. If your folders already point to a shared canonical skills directory, update that source rather than creating duplicate installations.

Codex

Current OpenAI skill documentation describes repository skills under .agents/skills and user skills under ~/.agents/skills. Install the four complete folders side by side in a supported location, then verify that Codex can discover them. Do not duplicate skills that are already exposed through your configured or shared skill directories.

For a fresh project installation, run this from the GenerateBlocks Skills checkout after replacing the destination:

mkdir -p /path/to/your-project/.agents/skills
cp -R skills/generateblocks-layouts skills/html-to-generateblocks \
  skills/elementor-to-generateblocks skills/figma-to-generateblocks \
  /path/to/your-project/.agents/skills/

Released installer caveat: bash install.sh codex in v2026.09.18 writes a combined ~/.codex/instructions.md. That legacy output is not the same as installing native skill directories. Do not assume that file is automatically loaded by your current Codex client. Prefer the native location above or explicitly ask Codex to read the repository's skill file.

Other installer outputs

These are the files written by the released script. Whether and how a client loads them depends on that client's configuration.

Option	Output	What to do next
windsurf	~/.windsurf/rules/generateblocks.md	Confirm the rule is enabled in your client
gemini	GEMINI.md in this checkout	Copy/merge it into the project where you work
copilot	.github/copilot-instructions.md in this checkout	Copy/merge it into the target repository
cline	.clinerules in this checkout	Use it in the intended project
aider	CONVENTIONS.md in this checkout	Add it to Aider's read context, for example through its read configuration

Combined files reference the original checkout's skill paths. Keep the checkout accessible, or update those paths if you move it. The script replaces generated destination files; preserve unrelated instructions before using these modes. --all runs every installer, so choose explicit options when you only need one client.

Release archives and chat uploads

Download the desired skill from Releases. Each .skill is byte-identical to its matching .zip; the extension does not change its contents. Use SHA256SUMS.txt if you want to verify the downloaded files.

Archive/file support varies by assistant. Uploading an archive as chat context is not necessarily persistent skill installation or permission to execute its scripts. If your client cannot inspect the archive, extract it and provide access to the folder. Standalone converter archives include the layout dependency under references/generateblocks-layouts/.

Verify and update

Ask the assistant to identify the skill path it loaded and locate references/authoring-contract.md and scripts/preflight.py. With converters, it should resolve the sibling layout skill or the bundled dependency, not invent a missing reference.

For a main-branch checkout, update with git pull --ff-only, then rerun the installer for the client you actually use. For copied native folders, refresh those folders from the updated source. Restart or refresh your client if it retains an older skill listing.

Next: Your First Layout.

---

Back to wiki home · Reference library