FrancyJGLisboa

Cliskill — Development skill for Claude Code

Development community

Your agents don't need to read the docs.

How to install Cliskill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open FrancyJGLisboa/cliskill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Cliskill does

Your agents don't need to read the docs. They need a tool that already did.

Alternatives in Development

Root Cause Tracing — Use when errors occur deep in execution and you need to trace back to find the original trigger 102.5k ★
Resume Work From A Handoff Document — You are tasked with resuming work from a handoff document through an interactive process 10k ★
Part 1 — Deep Research Prompt Builder — I'm going to help you create a research prompt for your project 2.1k ★

README

cliskill — AI-Agent-Friendly CLI Skill Framework

Your agents don't need to read the docs. They need a tool that already did.

![cliskill — Self-Bootstrapping CLI Skills for AI Agents](cliskill.png)

cliskill turns any reference material — API docs, repositories, PDFs, course materials, pasted text — into **self-bootstrapping CLI tools** that AI agents fully understand and users just clone and run. It delegates specification to [/clarity](https://github.com/FrancyJGLisboa/clarity), implementation to [/agent-skill-creator](https://github.com/FrancyJGLisboa/agent-skill-creator), and adds what neither has: an **automated evaluation-fix-rebuild loop**.

What This Is

A framework for generating self-installing, cross-platform, agent-friendly CLI skills from any reference material. The produced skills are git repos that work on any OS (`./skill` on macOS/Linux, `.\skill.ps1` on Windows) and any agent tool (Claude Code, Copilot, Cursor, Windsurf, Gemini CLI, Codex, Goose, OpenCode, Cline).

References → SPECIFY → BUILD → VERIFY → DEPLOY
                ↑        ↓
                ← REPAIR ←

One command in, deployed skill out. The vibe contract (3–5 binary success checks) is generated and verified internally — the human only sees it if something goes wrong. When the intent is ambiguous, cliskill asks once. Otherwise, zero interaction.

Install

**macOS / Linux:**

git clone https://github.com/FrancyJGLisboa/cliskill
cd cliskill
./cliskill

**Windows (PowerShell):**

git clone https://github.com/FrancyJGLisboa/cliskill
cd cliskill
.\cliskill.ps1

That's it. The installer:

Checks prerequisites (git, Python 3.10+) with OS-specific install guidance if missing
Detects your AI coding tool (Claude Code, Cursor, Copilot, Windsurf, Gemini CLI, Codex, Goose, OpenCode, Cline)
Installs to the vendor-neutral ~/.agents/skills/ path + all detected platform-specific paths
Installs both dependencies (/clarity, `/agent-skill-cr