# Repo to Claude Skill Converter (`ianymu/repo-to-claude-skill-converter`) Actor Convert any GitHub repository (CLI, library, API client) into a draft Claude Code Skill package (SKILL.md + install.sh + README) so Claude Code users can install that repo's capability as a one-line invocation. - **URL**: https://apify.com/ianymu/repo-to-claude-skill-converter.md - **Developed by:** [Yanlong Mu](https://apify.com/ianymu) (community) - **Categories:** AI, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### What does Repo to Claude Skill Converter do? **Repo to Claude Skill Converter** takes any **GitHub repository** — a CLI tool, a library, an API client — and produces a draft **Claude Code Skill** package (`SKILL.md` + `install.sh` + `README.md`) bundled as a single downloadable `.zip`. Anthropic released the [Claude Code Skills](https://docs.claude.com) ecosystem in late 2025; tool authors increasingly want their project wrapped as a Skill so Claude Code users can invoke it as a one-line capability. Writing a Skill by hand takes 30+ minutes per repo — this Actor automates ~70% of that work so you only need to review, polish, and publish. Try it on Apify Console by entering a repo like `astral-sh/ruff`, `vercel/next.js`, or `cli/cli` and downloading the generated `skill.zip` from the key-value store. ### Why use Repo to Claude Skill Converter? - **Bootstrap your Skill library fast** — wrap 10 favorite repos as Claude Code Skills in minutes. - **Tool authors** can offer a "Claude Code Skill" download as a marketing artifact next to their npm/pip page. - **Agencies and consultants** building bespoke Claude Code setups for clients can ship a tailored skill bundle per project. - **Reproducible** — the same repo produces the same Skill draft, perfect for CI pipelines. - **Apify platform advantages**: schedule re-generation on every upstream release, API access for batch processing, monitoring, integrations. ### How to use Repo to Claude Skill Converter 1. Open the Actor on Apify Console. 2. Enter `githubRepo` in the form `owner/name` (e.g. `astral-sh/ruff`). 3. Optionally set `skillName` to override the default (derived from the repo name). 4. Click **Start**. 5. When the run completes, download `skill.zip` from the **Key-Value Store** tab. 6. Unzip into `~/.claude/skills//`, run `sh install.sh`, restart Claude Code. ### Input | Field | Type | Required | Description | |---|---|---|---| | `githubRepo` | string | yes | `owner/name`, e.g. `vercel/next.js` | | `skillName` | string | no | Override auto-derived name; lowercase letters, digits, hyphens | Example input JSON: ```json { "githubRepo": "astral-sh/ruff", "skillName": "ruff" } ```` ### Output A row in the dataset summarizing what was generated, plus the actual files in the key-value store: - `skill.zip` — the bundle (`/SKILL.md`, `/install.sh`, `/README.md`). - `-SKILL.md` — convenience copy for direct viewing. - `-install.sh` — convenience copy. - `-README.md` — convenience copy. Example dataset item: ```json { "repo": "astral-sh/ruff", "skillName": "ruff", "detectedTool": { "type": "python-cli", "packageName": "ruff", "bin": "ruff", "installCmd": "pip install ruff" }, "skillMdSize": 1842, "installSize": 412, "zipBytes": 1721, "zipUrl": "see key-value store → skill.zip", "stars": 31000, "language": "Rust", "license": "MIT" } ``` You can download the dataset in JSON, HTML, CSV, or Excel. ### Data table | Field | Description | |---|---| | `repo` | Source GitHub repo (`owner/name`) | | `skillName` | Final skill name used in the zip and SKILL.md | | `detectedTool` | Object with `type`, `packageName`, `bin`, `installCmd` | | `skillMdSize` | Bytes of generated SKILL.md | | `installSize` | Bytes of generated install.sh | | `zipBytes` | Bytes of the final zip | | `stars` | GitHub stars at generation time | | `language` | Primary language reported by GitHub | | `license` | SPDX license id | ### Pricing / Cost estimation This Actor is lightweight — a single repo conversion does 2–8 GitHub API calls and bundles ~3 KB of generated text. On a typical Apify free tier, **one run costs well under $0.01** of compute. Batch 100 repos and you are still under $1. There is no proxy cost (uses public GitHub APIs). Set `GITHUB_TOKEN` as an environment variable in the Actor settings to raise the unauthenticated rate limit (60/hr → 5000/hr) — strongly recommended for batch usage. ### Tips and advanced options - **Batch mode**: orchestrate this Actor from another script — pass a list of repos and call the Actor once per repo via the Apify API. - **Pin versions**: edit the generated `install.sh` to pin to a specific release tag instead of latest. - **Library vs CLI**: the Actor detects `bin` fields in `package.json`, `[project.scripts]` in `pyproject.toml`, `[[bin]]` in `Cargo.toml`, and `main.go` for Go. If neither is found, it falls back to library-mode usage. - **Manual review**: the output is a **draft** — the generated SKILL.md gets ~70% there; review usage examples and constraints against the upstream README before publishing. ### FAQ, disclaimers, and support - **Is the generated SKILL.md production-ready?** It is a draft. Anthropic's Skill format is simple but the *content* (description, tips, constraints) benefits from human polish. - **What if my repo isn't a CLI?** The Actor handles libraries too — generated SKILL.md will show import-style usage instead of CLI commands. - **Does it run code?** No. It only reads `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, README, and repo metadata via the GitHub API. - **Custom solutions**: need a tailored Claude Code Skill build pipeline for your company? Open an issue or reach out via the Issues tab. Built by **Ian Mu** as Actor #10 in a [100-actor portfolio](https://github.com/ianymu). Pairs well with [claude-verify-before-stop](https://github.com/ianymu/claude-verify-before-stop) — the verification hook that makes sure Claude Code never claims "done" without proof. # Actor input Schema ## `githubRepo` (type: `string`): GitHub repo to convert into a Claude Code Skill, in 'owner/name' form. Example: 'vercel/next.js' or 'astral-sh/ruff'. ## `skillName` (type: `string`): Override the auto-derived skill name. Lowercase letters, digits, hyphens. If empty, derived from the repo name. ## Actor input object example ```json { "githubRepo": "astral-sh/ruff" } ``` # Actor output Schema ## `dataset` (type: `string`): No description ## `files` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "githubRepo": "astral-sh/ruff" }; // Run the Actor and wait for it to finish const run = await client.actor("ianymu/repo-to-claude-skill-converter").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "githubRepo": "astral-sh/ruff" } # Run the Actor and wait for it to finish run = client.actor("ianymu/repo-to-claude-skill-converter").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "githubRepo": "astral-sh/ruff" }' | apify call ianymu/repo-to-claude-skill-converter --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ianymu/repo-to-claude-skill-converter", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Repo to Claude Skill Converter", "description": "Convert any GitHub repository (CLI, library, API client) into a draft Claude Code Skill package (SKILL.md + install.sh + README) so Claude Code users can install that repo's capability as a one-line invocation.", "version": "0.1", "x-build-id": "s2JmvxUxV7Irm6BD4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ianymu~repo-to-claude-skill-converter/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ianymu-repo-to-claude-skill-converter", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ianymu~repo-to-claude-skill-converter/runs": { "post": { "operationId": "runs-sync-ianymu-repo-to-claude-skill-converter", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ianymu~repo-to-claude-skill-converter/run-sync": { "post": { "operationId": "run-sync-ianymu-repo-to-claude-skill-converter", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "githubRepo" ], "properties": { "githubRepo": { "title": "GitHub repository (owner/name)", "type": "string", "description": "GitHub repo to convert into a Claude Code Skill, in 'owner/name' form. Example: 'vercel/next.js' or 'astral-sh/ruff'." }, "skillName": { "title": "Skill name (optional)", "type": "string", "description": "Override the auto-derived skill name. Lowercase letters, digits, hyphens. If empty, derived from the repo name." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```