{"id":50486305,"url":"https://github.com/skullzarmy/skillerizer","last_synced_at":"2026-06-01T22:31:11.156Z","repository":{"id":346630904,"uuid":"1190849111","full_name":"skullzarmy/skillerizer","owner":"skullzarmy","description":"Feed a website, get a comprehensive skill on how to use it, or the information it contains. ","archived":false,"fork":false,"pushed_at":"2026-03-24T21:23:39.000Z","size":130,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-25T22:56:06.177Z","etag":null,"topics":["ai-agents","copilot-sdk","llm","skills","skills-md"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/skullzarmy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-24T17:18:11.000Z","updated_at":"2026-03-25T02:30:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/skullzarmy/skillerizer","commit_stats":null,"previous_names":["skullzarmy/skillerizer"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/skullzarmy/skillerizer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skullzarmy%2Fskillerizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skullzarmy%2Fskillerizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skullzarmy%2Fskillerizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skullzarmy%2Fskillerizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skullzarmy","download_url":"https://codeload.github.com/skullzarmy/skillerizer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skullzarmy%2Fskillerizer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33797126,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","copilot-sdk","llm","skills","skills-md"],"created_at":"2026-06-01T22:31:10.370Z","updated_at":"2026-06-01T22:31:11.150Z","avatar_url":"https://github.com/skullzarmy.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎯 Skillerizer\n\n**Feed a website or any content source, get a comprehensive Claude-style `skills.md` document.**\n\nSkillerizer is a locally-hosted web interface powered by the [**GitHub Copilot SDK**](https://github.com/github/copilot-sdk). It uses an agentic pipeline backed by Copilot's production-tested agent runtime. It has an upfront conversation to understand exactly what kind of skill you need — interactive guidance, knowledge extraction, or both — then coordinates multiple specialised AI agents to produce a high-quality `skills.md` document ready for use as AI agent context.\n\n![Skillerizer UI](https://github.com/user-attachments/assets/8d536db7-0dce-4585-8434-977b66b40812)\n\n---\n\n## Features\n\n- 🗣️ **Upfront clarification conversation** — the AI asks focused questions to understand your intent before generating anything\n- 🤖 **Agentic pipeline** powered by `@github/copilot-sdk`:\n    - **Clarifier** — captures skill purpose, consumer, and emphasis (persistent SDK session)\n    - **Analyzer** — classifies the source as `interaction`, `extraction`, or `hybrid` and extracts structured facts (ephemeral SDK session)\n    - **Writer** — streams a complete, well-formatted `skills.md` document (ephemeral SDK session with streaming)\n- 🔗 **URL or paste** — fetch any public URL, or paste raw text/docs directly\n- ⚡ **Real-time streaming** via SSE — watch the skill being written token by token\n- 📋 **Copy / Download** the final `skills.md` with one click\n- 🎨 **Modern dark-theme UI** — buttery-smooth, zero external framework dependencies\n- 🔑 **BYOK support** — use your own OpenAI, Anthropic, or Ollama keys via the SDK's provider config\n\n---\n\n## Quickstart\n\n### 1. Prerequisites\n\n- **Node.js ≥ 18**\n- **GitHub Copilot CLI** installed and in your PATH ([installation guide](https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli))\n    ```bash\n    copilot --version   # verify it's installed\n    ```\n- A **GitHub Copilot subscription** (free tier available), or BYOK API keys\n\n### 2. Install \u0026 configure\n\n```bash\ngit clone https://github.com/skullzarmy/skillerizer\ncd skillerizer\nnpm install\n# Optional — only needed for BYOK providers (OpenAI, Anthropic, Ollama)\ncp .env.example .env\n```\n\n### 3. Run\n\n```bash\nnpm start\n# → http://localhost:3000\n```\n\nOr for development with auto-reload:\n\n```bash\nnpm run dev\n```\n\n---\n\n## Configuration (`.env`)\n\n\u003e **If you're using the default GitHub Copilot provider**, you don't need to configure any environment variables. The GitHub Copilot CLI handles authentication automatically once installed and logged in (`copilot auth login`). The `.env` file is only needed for **BYOK (Bring Your Own Key)** setups when using a non-GitHub provider like OpenAI, Anthropic, or Ollama.\n\n| Variable            | Default                     | Description                                                   |\n| ------------------- | --------------------------- | ------------------------------------------------------------- |\n| `GITHUB_TOKEN`      | —                           | GitHub token (only needed if not using Copilot CLI auth)      |\n| `LLM_PROVIDER`      | `github`                    | `github` \\| `openai` \\| `ollama` \\| `anthropic`               |\n| `OPENAI_API_KEY`    | —                           | Required if `LLM_PROVIDER=openai`                             |\n| `OLLAMA_BASE_URL`   | `http://localhost:11434/v1` | Override if `LLM_PROVIDER=ollama`                             |\n| `ANTHROPIC_API_KEY` | —                           | Required if `LLM_PROVIDER=anthropic`                          |\n| `LLM_MODEL`         | `gpt-4o-mini`               | Override model (e.g. `gpt-4o`, `claude-sonnet-4.5`, `llama3`) |\n| `PORT`              | `3000`                      | HTTP server port                                              |\n\n---\n\n## How It Works\n\n```\nUser provides URL / pasted text\n        │\n        ▼\n  ┌─────────────┐\n  │  Clarifier  │  ← Persistent SDK session; asks 1-2 questions per turn\n  └─────────────┘    until intent is fully understood\n        │\n        ▼\n  ┌─────────────┐\n  │   Analyzer  │  ← Ephemeral SDK session; classifies \u0026 extracts JSON\n  └─────────────┘\n        │\n        ▼\n  ┌─────────────┐\n  │    Writer   │  ← Ephemeral SDK session w/ streaming; writes skills.md\n  └─────────────┘\n        │\n        ▼\n  Final skills.md  →  Copy / Download\n```\n\nEach agent is a **Copilot SDK session** with a specialised system prompt. The SDK manages conversation history, model interaction, and the underlying Copilot CLI process.\n\n---\n\n## API\n\n| Method | Path                             | Description                    |\n| ------ | -------------------------------- | ------------------------------ |\n| `POST` | `/api/session`                   | Create new session → `{id}`    |\n| `POST` | `/api/session/:id/source`        | Attach URL or text             |\n| `POST` | `/api/session/:id/clarify/start` | Trigger first AI question      |\n| `POST` | `/api/session/:id/message`       | Send a chat reply              |\n| `GET`  | `/api/session/:id/generate`      | SSE stream — run full pipeline |\n| `GET`  | `/api/session/:id`               | Session state                  |\n\n---\n\n## Project Structure\n\n```\nskillerizer/\n├── server.js              # Express entry point + Copilot SDK lifecycle\n├── src/\n│   ├── config.js          # CopilotClient singleton + session factory + BYOK\n│   ├── agents/\n│   │   ├── clarifier.js   # Clarification agent (persistent SDK session)\n│   │   ├── analyzer.js    # Content analysis agent (ephemeral SDK session)\n│   │   ├── writer.js      # skills.md generation agent (streaming SDK session)\n│   │   └── orchestrator.js# Pipeline coordinator\n│   ├── tools/\n│   │   └── fetcher.js     # URL → clean text extractor\n│   └── routes/\n│       └── api.js         # REST + SSE routes + SDK session management\n└── public/\n    ├── index.html\n    ├── css/main.css\n    └── js/app.js\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskullzarmy%2Fskillerizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskullzarmy%2Fskillerizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskullzarmy%2Fskillerizer/lists"}