{"id":35745368,"url":"https://github.com/netresearch/skill-repo-skill","last_synced_at":"2026-05-23T07:07:57.093Z","repository":{"id":328940316,"uuid":"1117442268","full_name":"netresearch/skill-repo-skill","owner":"netresearch","description":"Agent Skill guide for structuring skill repositories - multi-channel distribution | Claude Code compatible","archived":false,"fork":false,"pushed_at":"2026-05-23T05:48:31.000Z","size":489,"stargazers_count":7,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-23T06:36:22.435Z","etag":null,"topics":["agent-skills","ai-agent","open-standard"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netresearch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-CC-BY-SA-4.0","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY-AUDIT.md","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":"2025-12-16T10:15:03.000Z","updated_at":"2026-05-23T05:48:34.000Z","dependencies_parsed_at":"2026-01-13T23:00:50.335Z","dependency_job_id":"3fc47609-fc5f-4d01-8af0-2296d55dc793","html_url":"https://github.com/netresearch/skill-repo-skill","commit_stats":null,"previous_names":["netresearch/skill-repo-skill"],"tags_count":46,"template":false,"template_full_name":null,"purl":"pkg:github/netresearch/skill-repo-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fskill-repo-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fskill-repo-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fskill-repo-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fskill-repo-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netresearch","download_url":"https://codeload.github.com/netresearch/skill-repo-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fskill-repo-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33386093,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","ai-agent","open-standard"],"created_at":"2026-01-06T17:24:05.553Z","updated_at":"2026-05-23T07:07:57.087Z","avatar_url":"https://github.com/netresearch.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Skill Repository Structure Guide\n\nA Claude Code skill for standardizing Netresearch skill repository layout, distribution channels, packaging, and validation.\n\n## What this skill solves\n\nNetresearch maintains many agent skills; without a shared layout, packaging and CI drift across repositories. This skill defines **one standard repo shape**, reusable workflows, split licensing, and validation scripts so new and existing skills stay consistent and shippable via marketplace, Composer, npm, and releases.\n\nIt extends Anthropic-style single-file skills with **repository-level** conventions (not a replacement for Anthropic’s skill-creator — see comparison below).\n\n## Compatibility\n\nThis is an **Agent Skill** following the [open standard](https://agentskills.io) originally developed by Anthropic and released for cross-platform use.\n\n**Supported platforms:**\n\n- Claude Code (Anthropic)\n- Cursor\n- GitHub Copilot\n- Other skills-compatible AI agents\n\n\u003e Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.\n\n## Use when\n\n- Creating or bootstrapping a **Netresearch-style skill repository**\n- Standardizing layout, `composer.json`, `.claude-plugin/plugin.json`, or release workflows\n- Wiring **reusable CI** from `netresearch/skill-repo-skill`\n- Fixing **validation errors** from `validate-skill.sh` or marketplace packaging\n- Migrating to **split licensing** (`LICENSE-MIT` + `LICENSE-CC-BY-SA-4.0`)\n\n## Expected outputs\n\n- A documented **directory layout** and templates for new repos\n- **Validation**: structural checks for `SKILL.md`, licenses, `composer.json`, `plugin.json`\n- **Release discipline**: tag-driven packaging aligned with plugin version\n- **References** for installation paths, marketplace sync, and release safety\n\n## Context requirements\n\n- **Validation script**: `bash` 4.3+ and `python3` on PATH when running `validate-skill.sh` (JSON checks use Python, not `jq`)\n- **Target repos**: GitHub-hosted Netresearch skill repos using split licensing and Composer type `ai-agent-skill`\n- **CI**: consuming repos call reusable workflows from this repository (`validate.yml`, `release.yml`, …)\n\n## Example prompts\n\n```\n\"Scaffold a new Netresearch skill repository from the templates in skill-repo-skill.\"\n\"Why does validate-skill.sh fail on my SKILL.md frontmatter?\"\n\"Add composer.json and plugin.json for our new skill repo matching netresearch conventions.\"\n\"Wire our repo to use netresearch/skill-repo-skill validate.yml on every PR.\"\n\"Migrate this repo from a single LICENSE file to LICENSE-MIT and LICENSE-CC-BY-SA-4.0.\"\n```\n\n## Related skills\n\n- [`agent-rules-skill`](https://github.com/netresearch/agent-rules-skill) — AGENTS.md and agent onboarding patterns\n- [`agent-harness-skill`](https://github.com/netresearch/agent-harness-skill) — harness verification and docs layout\n\n## Installation\n\n### Marketplace (recommended)\n\nAdd the [Netresearch marketplace](https://github.com/netresearch/claude-code-marketplace) once, then browse and install skills:\n\n```bash\n/plugin marketplace add netresearch/claude-code-marketplace\n```\n\n### npx ([skills.sh](https://skills.sh))\n\nInstall with any [Agent Skills](https://agentskills.io)-compatible agent:\n\n```bash\nnpx skills add https://github.com/netresearch/skill-repo-skill --skill skill-repo\n```\n\n### Download release\n\nDownload the [latest release](https://github.com/netresearch/skill-repo-skill/releases/latest) and extract to your agent’s skills directory.\n\n### Git clone\n\n```bash\ngit clone https://github.com/netresearch/skill-repo-skill.git\n```\n\n### Composer (PHP projects)\n\n```bash\ncomposer require netresearch/skill-repo-skill\n```\n\nRequires [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin).\n\n### npm (Node projects)\n\n```bash\nnpm install --save-dev \\\n  @netresearch/agent-skill-coordinator \\\n  github:netresearch/skill-repo-skill\n```\n\nRequires [@netresearch/agent-skill-coordinator](https://github.com/netresearch/node-agent-skill-coordinator), which discovers the skill in `node_modules` and registers it in `AGENTS.md` via a `postinstall` hook. For pnpm, allowlist the coordinator’s postinstall:\n\n```json\n{\n  \"pnpm\": {\n    \"onlyBuiltDependencies\": [\"@netresearch/agent-skill-coordinator\"]\n  }\n}\n```\n\n## Repository layout\n\n### Standard skill repository (concept)\n\nThe layout for a Netresearch skill repository (one or more skills per repo):\n\n```\n{name}-skill/\n├── AGENTS.md                        # Agent rules / harness index\n├── README.md                        # Human documentation\n├── LICENSE-MIT                      # Code license (MIT)\n├── LICENSE-CC-BY-SA-4.0             # Content license (CC-BY-SA-4.0)\n├── composer.json                    # PHP distribution\n├── package.json                     # Node distribution (optional)\n├── renovate.json                    # Dependency automation\n├── .claude-plugin/\n│   └── plugin.json                  # Marketplace metadata\n├── .github/workflows/               # CI (typically calls reusable workflows)\n├── Build/                           # Build scripts and git hooks\n├── docs/                            # Architecture, ADRs, dashboards\n├── scripts/                         # Repo-level automation\n└── skills/\n    └── {skill-name}/\n        ├── SKILL.md                 # AI instructions\n        ├── checkpoints.yaml         # Assessment checkpoints (optional)\n        ├── evals/                   # Skill evaluations\n        ├── references/              # Extended docs\n        ├── scripts/                 # Skill automation\n        └── templates/               # Bootstrap templates\n```\n\n### Installation methods (summary)\n\n1. **Marketplace** — `/plugin marketplace add netresearch/claude-code-marketplace`\n2. **npx (skills.sh)** — `npx skills add \u003crepo-url\u003e --skill \u003cname\u003e`\n3. **Release download** — GitHub Releases (skill files only)\n4. **Git clone** — direct clone\n5. **Composer** — `composer require netresearch/\u003crepo-name\u003e` (PHP projects)\n6. **npm** — coordinator + `github:\u003corg\u003e/\u003crepo\u003e` (Node projects)\n\n### Composer package requirements\n\n- `\"type\": \"ai-agent-skill\"`\n- `\"require\": {\"netresearch/composer-agent-skill-plugin\": \"*\"}`\n- `\"extra\": {\"ai-agent-skill\": \"skills/{skill-name}/SKILL.md\"}`\n\n### This repository (`skill-repo-skill`)\n\nThis repo **dogfoods** the layout and hosts reusable CI workflows for other Netresearch skill repos:\n\n```\nskill-repo-skill/\n├── AGENTS.md\n├── README.md\n├── LICENSE-MIT\n├── LICENSE-CC-BY-SA-4.0\n├── SECURITY-AUDIT.md\n├── composer.json\n├── package.json\n├── renovate.json\n├── .claude-plugin/plugin.json\n├── .github/workflows/             # validate, release, pr-quality,\n│                                  # harness-verify, eval-validate,\n│                                  # validate-agents, dependency-audit,\n│                                  # npm-pack-smoke, ci-python\n│                                  # (auto-merge delegates to netresearch/.github)\n├── Build/\n│   ├── Scripts/check-plugin-version.sh\n│   └── hooks/\n├── docs/\n│   ├── ARCHITECTURE.md\n│   └── dashboard/\n├── scripts/\n├── tests/\n└── skills/skill-repo/\n    ├── SKILL.md\n    ├── checkpoints.yaml\n    ├── evals/evals.json\n    ├── references/\n    ├── scripts/\n    └── templates/\n```\n\nSee [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) for component responsibilities.\n\n## Extends Anthropic's Skill Creator\n\nThis skill **extends** (not replaces) Anthropic’s skill-creator:\n\n| Aspect | Anthropic's skill-creator | This skill adds |\n| --- | --- | --- |\n| Focus | SKILL.md content | Repository structure |\n| Scope | Single file | Full repo layout |\n| Distribution | Claude Code native | + Marketplace, Composer |\n| Audience | AI instructions | + Human README |\n\n## Contributing\n\nContributions welcome. Please open PRs for:\n\n- Template improvements\n- Additional validation checks\n- Documentation updates\n\n## License\n\nThis project uses split licensing:\n\n- **Code** (scripts, workflows, configs): [MIT](LICENSE-MIT)\n- **Content** (skill definitions, documentation, references): [CC-BY-SA-4.0](LICENSE-CC-BY-SA-4.0)\n\nSee the individual license files for full terms.\n\n## Credits\n\nDeveloped and maintained by [Netresearch DTT GmbH](https://www.netresearch.de/).\n\n---\n\n**Made with ❤️ for Open Source by [Netresearch](https://www.netresearch.de/)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fskill-repo-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetresearch%2Fskill-repo-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fskill-repo-skill/lists"}