{"id":50524550,"url":"https://github.com/guorunjie/skillpack-forge","last_synced_at":"2026-06-03T07:01:10.476Z","repository":{"id":360693238,"uuid":"1251111044","full_name":"guorunjie/skillpack-forge","owner":"guorunjie","description":"One manifest for every AI coding agent: generate AGENTS.md, Claude Skills, Codex Skills, Cursor rules, and Copilot instructions.","archived":false,"fork":false,"pushed_at":"2026-05-27T12:59:51.000Z","size":28,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-27T14:24:47.472Z","etag":null,"topics":["agent-skills","agents-md","ai-agents","automation","claude-skills","codex-skills","copilot-instructions","cursor-rules","developer-tools","mcp","repo-context","skillpack","workflow-automation"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/guorunjie.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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-27T08:53:24.000Z","updated_at":"2026-05-27T13:40:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/guorunjie/skillpack-forge","commit_stats":null,"previous_names":["guorunjie/skillpack-forge"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/guorunjie/skillpack-forge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guorunjie%2Fskillpack-forge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guorunjie%2Fskillpack-forge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guorunjie%2Fskillpack-forge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guorunjie%2Fskillpack-forge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guorunjie","download_url":"https://codeload.github.com/guorunjie/skillpack-forge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guorunjie%2Fskillpack-forge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33833459,"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-02T02:00:07.132Z","response_time":109,"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":["agent-skills","agents-md","ai-agents","automation","claude-skills","codex-skills","copilot-instructions","cursor-rules","developer-tools","mcp","repo-context","skillpack","workflow-automation"],"created_at":"2026-06-03T07:00:54.191Z","updated_at":"2026-06-03T07:01:10.388Z","avatar_url":"https://github.com/guorunjie.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Skillpack Forge\n\n[![test](https://github.com/guorunjie/skillpack-forge/actions/workflows/test.yml/badge.svg)](https://github.com/guorunjie/skillpack-forge/actions/workflows/test.yml)\n[![npm](https://img.shields.io/npm/v/skillpack-forge.svg)](https://www.npmjs.com/package/skillpack-forge)\n[![GitHub release](https://img.shields.io/github/v/release/guorunjie/skillpack-forge?include_prereleases\u0026sort=semver)](https://github.com/guorunjie/skillpack-forge/releases)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](package.json)\n[![Live demo](https://img.shields.io/badge/live-demo-blue)](https://github.com/guorunjie/skillpack-forge-demo)\n\nSkillpack Forge turns one repo manifest into portable agent instructions, skills, rules, MCP resources, MCPB-ready manifests, and local MCPB bundles for AGENTS.md, CLAUDE.md, Claude, Codex, Cursor, GitHub Copilot, and MCP clients.\n\nAI coding tools now ask for the same project knowledge in different formats: `AGENTS.md`, `CLAUDE.md`, Claude Skills, Codex Skills, Cursor rules, GitHub Copilot instructions, MCP resources, local MCP bundle manifests, and `.mcpb` bundles. Skillpack Forge gives maintainers one source of truth.\n\n![Skillpack Forge terminal demo](docs/assets/terminal-demo.svg)\n\nWant to inspect a real generated repo first? Open the [live fixture demo](https://github.com/guorunjie/skillpack-forge-demo). It checks in one `skillpack.yaml`, every generated target file, a packed `.mcpb` bundle, and a passing GitHub Actions workflow.\n\n## Try It In 30 Seconds\n\n```bash\nnpx skillpack-forge@latest init .\nnpx skillpack-forge@latest compile . --dry-run\nnpx skillpack-forge@latest compile .\nnpx skillpack-forge@latest doctor .\nnpx skillpack-forge@latest diff .\nnpx skillpack-forge@latest check . --strict\nnpx skillpack-forge@latest mcpb .\n```\n\nNo global install is required: the CLI is published on [npm](https://www.npmjs.com/package/skillpack-forge) and works through `npx`.\n\nIt scans the repo, writes `skillpack.yaml`, then compiles it into:\n\n- `AGENTS.md`\n- `CLAUDE.md`\n- `.claude/skills/\u003cskill\u003e/SKILL.md`\n- `.codex/skills/\u003cskill\u003e/SKILL.md`\n- `.cursor/rules/\u003cproject\u003e.mdc`\n- `.github/copilot-instructions.md`\n- `.mcp/manifest.json`\n- `.mcp/skillpack-server.mjs`\n- `.mcp/README.md`\n\n## Target Matrix\n\n| Target | Generated path | Intended client | Output type |\n| --- | --- | --- | --- |\n| `agents` | `AGENTS.md` | Codex and other AGENTS.md-aware coding agents | Repo instructions |\n| `claude-md` | `CLAUDE.md` | Claude Code | Repo instructions |\n| `claude` | `.claude/skills/\u003cskill\u003e/SKILL.md` | Claude Skills-compatible agents | Skill |\n| `codex` | `.codex/skills/\u003cskill\u003e/SKILL.md` | Codex Skills-compatible agents | Skill |\n| `cursor` | `.cursor/rules/\u003cproject\u003e.mdc` | Cursor | Rule |\n| `copilot` | `.github/copilot-instructions.md` | GitHub Copilot | Repo instructions |\n| `mcp` | `.mcp/manifest.json`, `.mcp/skillpack-server.mjs`, optional `.mcpb` bundle | MCP clients and MCPB-aware installers | Local read-only MCP server plus MCPB packaging |\n\nStart from an automation template instead:\n\n```bash\nnpx skillpack-forge@latest new browser-automation .\nnpx skillpack-forge@latest new playwright-browser .\nnpx skillpack-forge@latest new test-automation .\nnpx skillpack-forge@latest new ci-triage .\nnpx skillpack-forge@latest new dependency-upgrade .\nnpx skillpack-forge@latest new data-pipeline .\nnpx skillpack-forge@latest compile . --dry-run\n```\n\nBrowse the [automation skillpack gallery](docs/skillpack-gallery.md) for all templates and generated examples.\n\nImport existing agent files into one manifest:\n\n```bash\nnpx skillpack-forge@latest import . --force\n```\n\nSkillpack Forge is a compiler for repo-specific agent instructions, not a skill registry, skill installer, readiness-score linter, or agent runtime. See [how it differs](docs/how-it-differs.md) and the [competitive analysis](docs/competitive-analysis.md).\n\n## Why This Can Win Stars\n\nThe high-star signal is clear: developers are collecting agent instructions and skills, but the ecosystem is fragmented.\n\n- [`agentsmd/agents.md`](https://github.com/agentsmd/agents.md): simple repo-level agent guidance format.\n- [`github/awesome-copilot`](https://github.com/github/awesome-copilot): community instructions, agents, skills, and configurations for GitHub Copilot.\n- [`anthropics/skills`](https://github.com/anthropics/skills): public repository for Agent Skills.\n- [`addyosmani/agent-skills`](https://github.com/addyosmani/agent-skills): production-grade engineering skills for coding agents.\n- [`microsoft/playwright-mcp`](https://github.com/microsoft/playwright-mcp) and [`github/github-mcp-server`](https://github.com/github/github-mcp-server): MCP is becoming a default automation surface.\n- [`vercel-labs/agent-browser`](https://github.com/vercel-labs/agent-browser): browser automation for AI agents is already a high-interest category.\n\nSkillpack Forge sits between those trends: it is not another list of prompts, and it is not a full workflow platform. It is the missing compiler that lets any repo ship consistent agent context everywhere.\n\n## Quick Start\n\nUse the npm CLI:\n\n```bash\nnpx skillpack-forge@latest --help\n```\n\nCreate a skillpack for any project:\n\n```bash\nnpx skillpack-forge@latest init /path/to/project\nnpx skillpack-forge@latest compile /path/to/project --dry-run\nnpx skillpack-forge@latest compile /path/to/project\nnpx skillpack-forge@latest doctor /path/to/project\nnpx skillpack-forge@latest diff /path/to/project\nnpx skillpack-forge@latest check /path/to/project --strict\nnpx skillpack-forge@latest mcpb /path/to/project\n```\n\nInspect a repo without writing files:\n\n```bash\nnpx skillpack-forge@latest scan /path/to/project --json\n```\n\nGenerate a template skillpack:\n\n```bash\nnpx skillpack-forge@latest new --list\nnpx skillpack-forge@latest new release-automation /path/to/project\nnpx skillpack-forge@latest new dependency-upgrade /path/to/project\n```\n\nImport existing agent files:\n\n```bash\nnpx skillpack-forge@latest import /path/to/project\n```\n\nCompile an Agentic Workflow Guard safety skillpack:\n\n```bash\nnode ../agentic-workflow-guard/bin/agentic-workflow-guard.js skillpack \u003e skillpack.yaml\nnpx skillpack-forge@latest compile . --dry-run\nnpx skillpack-forge@latest compile .\nnpx skillpack-forge@latest doctor .\nnpx skillpack-forge@latest diff .\nnpx skillpack-forge@latest check . --strict\n```\n\nThis gives automation security projects a portable context bundle for `AGENTS.md`, Claude Skills, Codex Skills, Cursor rules, and Copilot instructions. See [Agentic Workflow Guard](https://github.com/guorunjie/agentic-workflow-guard) for the scanner side of the workflow.\n\n## Example Manifest\n\nSee [`examples/skillpack.yaml`](examples/skillpack.yaml) and the generated files in [`examples/AGENTS.md`](examples/AGENTS.md), `examples/.claude/skills`, `examples/.codex/skills`, `examples/.cursor/rules`, and `examples/.github/copilot-instructions.md`.\n\nFor template-driven examples, see the [automation skillpack gallery](docs/skillpack-gallery.md) and the [generated examples index](examples/generated/README.md). For an end-to-end public fixture, see [guorunjie/skillpack-forge-demo](https://github.com/guorunjie/skillpack-forge-demo).\n\n```yaml\nname: \"my-agent-tool\"\nsummary: \"Browser automation CLI for recurring operator workflows\"\ntargets:\n  - \"agents\"\n  - \"claude-md\"\n  - \"claude\"\n  - \"codex\"\n  - \"cursor\"\n  - \"copilot\"\n  - \"mcp\"\nprinciples:\n  - \"Preserve user changes and keep edits scoped\"\n  - \"Inspect the current repo state before changing files\"\n  - \"Run verification before claiming success\"\ncommands:\n  install: \"npm install\"\n  test: \"npm test\"\n  lint: \"npm run lint\"\nskills:\n  - name: \"my-agent-tool-developer\"\n    description: \"Use when changing, testing, or automating my-agent-tool.\"\n    workflow:\n      - \"Inspect the current project context and nearby files\"\n      - \"Run npm test before completion\"\n      - \"Document any command that cannot be run\"\n```\n\n## CLI\n\n### `scan`\n\nDetects project metadata, package managers, useful commands, docs, and automation capabilities.\n\n```bash\nskillpack-forge scan .\nskillpack-forge scan . --json\n```\n\n### `init`\n\nCreates `skillpack.yaml` from the scan.\n\n```bash\nskillpack-forge init .\nskillpack-forge init . --force\n```\n\n### `import`\n\nCreates `skillpack.yaml` from existing agent files such as `AGENTS.md`, `.github/copilot-instructions.md`, `.cursor/rules/*.mdc`, `.claude/skills/*/SKILL.md`, and `.codex/skills/*/SKILL.md`.\n\n```bash\nskillpack-forge import .\nskillpack-forge import . --force\nskillpack-forge import . --json\n```\n\nFor Cursor rules, import preserves supported frontmatter in a top-level `cursor` block:\n\n```yaml\ncursor:\n  description: \"Use for TypeScript source and tests.\"\n  globs:\n    - \"src/**/*.ts\"\n    - \"test/**/*.ts\"\n  alwaysApply: false\n```\n\nWhen multiple Cursor rule files are imported, Skillpack Forge unions `globs`, keeps the first description, and sets `alwaysApply` to true if any imported rule is always-on. Per-rule ordering and unsupported Cursor metadata remain outside the current single-rule output model.\n\n### `new`\n\nCreates a template manifest for common automation skillpacks.\n\n```bash\nskillpack-forge new --list\nskillpack-forge new browser-automation .\nskillpack-forge new playwright-browser .\nskillpack-forge new test-automation .\nskillpack-forge new ci-triage .\nskillpack-forge new dependency-upgrade .\nskillpack-forge new docs-automation .\nskillpack-forge new release-automation .\nskillpack-forge new ops-automation .\nskillpack-forge new data-automation .\nskillpack-forge new data-pipeline .\n```\n\n### `compile`\n\nCompiles `skillpack.yaml` into the selected targets. Use `--dry-run` first to list files that would be created or overwritten without changing the repo.\n\n```bash\nskillpack-forge compile .\nskillpack-forge compile . --dry-run\n```\n\n### `mcpb`\n\nPacks the generated `.mcp` directory into a local `.mcpb` bundle without adding runtime dependencies. Run `compile` first so `.mcp/manifest.json` and `.mcp/skillpack-server.mjs` exist.\n\n```bash\nskillpack-forge mcpb .\nskillpack-forge mcpb . dist/my-project-skillpack.mcpb\n```\n\n### `doctor`\n\nChecks that generated files exist and do not contain placeholder text.\n\n```bash\nskillpack-forge doctor .\n```\n\n### `diff`\n\nChecks whether generated files match the current `skillpack.yaml`. This exits non-zero when generated agent instructions are missing or stale, which makes it useful in CI.\n\n```bash\nskillpack-forge diff .\n```\n\n### `check`\n\nRuns `doctor` and `diff` as one CI-friendly command. Use `--strict` to also fail on unexpected old Skillpack Forge generated files.\n\n```bash\nskillpack-forge check .\nskillpack-forge check . --strict\n```\n\n### JSON Schema\n\nUse [`skillpack.schema.json`](skillpack.schema.json) to validate manifest shape in editors or CI. The schema covers the current portable targets: AGENTS.md, CLAUDE.md, Claude Skills, Codex Skills, Cursor rules, Copilot instructions, MCP resources, and MCPB-ready manifests.\n\n### MCP Server\n\nAdd `mcp` to `targets` to generate a zero-dependency local MCP stdio server and MCPB manifest:\n\n```bash\nskillpack-forge compile .\nnode .mcp/skillpack-server.mjs\n```\n\nThe generated server exposes read-only resources and tools for the manifest, summary, commands, and workflows. Pack the generated `.mcp` directory into a local `.mcpb` bundle:\n\n```bash\nskillpack-forge mcpb . my-project-skillpack.mcpb\n```\n\nRun an additional official MCPB schema check when needed:\n\n```bash\nnpx -y @anthropic-ai/mcpb validate .mcp\n```\n\nSee `.mcp/README.md` after compilation, the [MCP packaging design note](docs/mcp-packaging.md), and the [MCP client setup examples](docs/mcp-client-setup.md).\n\n### GitHub Action\n\nUse the bundled action to keep generated files fresh in pull requests:\n\n```yaml\n- uses: guorunjie/skillpack-forge@v1\n  with:\n    path: .\n```\n\nSee the [GitHub Action guide](docs/github-action.md).\n\n## Positioning\n\nSkillpack Forge is for:\n\n- open-source maintainers who want every coding agent to understand their repo quickly;\n- teams that already maintain separate Copilot, Cursor, Claude, and Codex instructions;\n- automation tool builders who want reusable skill packs around browser, ops, data, or workflow tasks;\n- agent framework authors who need a clean bridge from repo context to tool-specific instructions.\n\nIt is intentionally small: no hosted service, no database, no LLM dependency, no lock-in.\n\n## Roadmap\n\nRecently delivered:\n\n- Animated terminal demo for the README first screen.\n- Target compatibility matrix across AGENTS.md, Claude, Codex, Cursor, Copilot, and MCP.\n- Test automation template and generated example.\n- CI triage template and generated example.\n- Data pipeline automation template and generated example.\n- MCPB-ready manifest generation for local MCP servers.\n- Public automation skillpack gallery with generated examples for every template.\n- Zero-dependency MCPB bundle packing via `skillpack-forge mcpb`.\n\nNext:\n\n- Optional MCPB signing and install-flow documentation after user feedback.\n- Public gallery of reusable automation skillpacks.\n- Community starter issues for templates, MCP docs, and importer improvements.\n\n## Development\n\n```bash\nnpm test\nnode ./bin/skillpack-forge.js scan . --json\nnode ./bin/skillpack-forge.js doctor .\nnode ./bin/skillpack-forge.js diff .\n```\n\nThe implementation is dependency-free Node.js so the CLI stays easy to audit and install.\n\nContributions are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md), browse the [community roadmap](docs/community-roadmap.md), read the [community skillpack submission guide](docs/community-skillpacks.md), join [Discussions](https://github.com/guorunjie/skillpack-forge/discussions), or open a template request for a workflow you want Skillpack Forge to generate. Sharing the project? Use the [share kit](docs/share-kit.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguorunjie%2Fskillpack-forge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguorunjie%2Fskillpack-forge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguorunjie%2Fskillpack-forge/lists"}