feat(distribution): package repo as Claude Code plugin marketplace, probe directory submission paths, extend topics to 18

Author: francescobianco

.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "openapi",
+  "owner": {
+    "name": "Openapi",
+    "url": "https://openapi.com"
+  },
+  "metadata": {
+    "description": "Official Openapi plugin marketplace",
+    "version": "0.1.0"
+  },
+  "plugins": [
+    {
+      "name": "openapi-skills",
+      "source": "./",
+      "description": "Agent skills for the Openapi API marketplace: company data, official documents, KYC/risk, verification, geo data, messaging, e-signatures, invoicing, automotive and utilities.",
+      "category": "api-integration",
+      "keywords": ["openapi", "api", "company-data", "kyc", "e-invoicing", "italy"]
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "openapi-skills",
+  "displayName": "Openapi Skills",
+  "description": "Agent skills for the Openapi API marketplace: company data (IT/EU/worldwide), official Italian business documents, KYC/risk reports, data verification, geocoding and cadastre, SMS/PEC/postal messaging, eIDAS e-signatures, electronic invoicing via SDI, automotive data and utilities.",
+  "version": "0.1.0",
+  "author": {
+    "name": "Openapi",
+    "url": "https://openapi.com"
+  },
+  "homepage": "https://github.com/openapi/openapi-skills",
+  "repository": "https://github.com/openapi/openapi-skills",
+  "license": "MIT",
+  "keywords": [
+    "openapi",
+    "api",
+    "company-data",
+    "kyc",
+    "e-invoicing",
+    "e-signature",
+    "italy",
+    "skills"
+  ]
+}

.github/workflows/skills.yml

@@ -1,4 +1,4 @@
-name: Skills CI
+name: build
 
 on:
   push:

DISTRIBUTION.md

@@ -20,17 +20,17 @@ The highest-value targets: users install directly from here.
 |---|---|---|---|---|---|
 | Skills.sh (Vercel) | https://www.skills.sh/ | Indexed from public GitHub repos with `skills/*/SKILL.md`; installs counted via `npx skills add openapi/openapi-skills`. Verify the repo appears in search | submitted | 2026-06-10 | Install command verified working (11 skills detected, installs to 19+ agents); first install registered. Re-check search indexing in a few days |
 | SkillX | https://github.com/nextlevelbuilder/skillx | Marketplace with semantic search/ratings; submit per their CLI/registry flow | todo | | |
-| Skills Directory | https://www.skillsdirectory.com/ | Submission with security scan (malware/prompt injection review) | todo | | Security-vetted listing is good trust signal for a B2B brand |
+| Skills Directory | https://www.skillsdirectory.com/ | **Manual web form** at https://www.skillsdirectory.com/submit (reviewed before publishing) | todo | | Security-vetted listing is good trust signal for a B2B brand. Form is client-side — needs a human, ~2 min |
 | MCP Market — Skills section | https://mcpmarket.com/tools/skills | Submit skill/tool via their form | todo | | Same site can also list the Openapi MCP server |
-| Claude Skills Hub | https://claudeskills.info/ | Submission/indexing of SKILL.md repos | todo | | 658+ skills indexed, 13 categories |
-| AwesomeSkills.dev | https://www.awesomeskills.dev/en | Directory for cross-tool skills (14+ agents) | todo | | |
+| Claude Skills Hub | https://claudeskills.info/ | Submission/indexing of SKILL.md repos | todo | | 658+ skills indexed; site blocks automated fetch (403) — check submission path manually |
+| AwesomeSkills.dev | https://www.awesomeskills.dev/en | **Manual web form** at https://www.awesomeskills.dev/en/submit — paste the GitHub URL, auto-detects everything, live instantly (no moderation) | todo | | Client-side React form, no public API — needs a human, ~30 s |
 | LLMBase skills directory | https://llmbase.ai/skills/ | Submission form | todo | | |
 
 ## 2. Official Anthropic channels
 
 | Channel | URL | How to get listed | Status | Date | Notes |
 |---|---|---|---|---|---|
-| Claude Code official plugin marketplace | https://github.com/anthropics/claude-plugins-official | Package the repo as a plugin (`.claude-plugin/plugin.json` + `skills/`) and use the plugin directory submission form (see https://code.claude.com/docs/en/plugins) | todo | | Requires plugin packaging — quality/security review by Anthropic |
+| Claude Code official plugin marketplace | https://github.com/anthropics/claude-plugins-official | Package the repo as a plugin (`.claude-plugin/plugin.json` + `skills/`) and use the plugin directory submission form (see https://code.claude.com/docs/en/plugins) | todo | 2026-06-10 | **Packaging done**: `.claude-plugin/plugin.json` + `marketplace.json`, `claude plugin validate` passes. Repo now works with `/plugin marketplace add openapi/openapi-skills`. Next: submission form |
 | anthropics/skills (official examples repo) | https://github.com/anthropics/skills | PR if/where third-party skills are accepted | todo | | Check current contribution policy first |
 
 ## 3. Awesome lists (GitHub PRs)
@@ -60,7 +60,7 @@ Free, do first — improves indexing by every crawler-based directory above.
 
 | Action | Status | Date | Notes |
 |---|---|---|---|
-| Add repo topics: `agent-skills`, `claude-skills`, `claude-code`, `skills`, `openapi`, `api`, `ai-agents` | listed | 2026-06-10 | Done via `gh repo edit` |
+| Add repo topics (18: agent-skills, claude-skills, claude-code, skills, skill-md, openapi, api, rest-api, http-client, certified-api, api-marketplace, ai-agents, company-data, kyc, e-invoicing, digital-signature, geocoding, italy) | listed | 2026-06-10 | Done via `gh repo edit`, extended together with Francesco |
 | Set repo description + website (https://openapi.com) | listed | 2026-06-10 | Done via `gh repo edit` |
 | Tag a release (`v0.1.0`) | listed | 2026-06-10 | https://github.com/openapi/openapi-skills/releases/tag/v0.1.0 |
 | Pin the repo on the `openapi` org profile | todo | | Needs org admin via web UI |
@@ -115,4 +115,7 @@ Not this repo, but the same audience: each MCP listing should cross-link the ski
 | 2026-06-10 | Verified `npx skills add openapi/openapi-skills`: 11 skills detected and installed correctly; first install registered with skills.sh telemetry (repo not yet in their search — re-check in a few days) |
 | 2026-06-10 | Reviewed contribution policies of the 4 main awesome lists: VoltAgent deferred (maturity requirement), ComposioHQ n/a (in-repo skills), travisvn at-risk (no-promotion policy) |
 | 2026-06-10 | PR [#276](https://github.com/heilcheng/awesome-agent-skills/pull/276) opened on heilcheng/awesome-agent-skills ("Skills by Openapi", 11 entries, affiliation disclosed) |
-| 2026-06-10 | Repo polish: branded README header, Skills CI workflow (lint + zip bundles + release assets) |
+| 2026-06-10 | Repo polish: branded README header, Skills CI workflow (lint + zip bundles + release assets) — first run green |
+| 2026-06-10 | Plugin packaging: `.claude-plugin/plugin.json` + `marketplace.json` added and validated (`claude plugin validate`) — repo installable via `/plugin marketplace add openapi/openapi-skills`; prerequisite for the official Anthropic marketplace done |
+| 2026-06-10 | Probed submission paths: awesomeskills.dev (manual form, instant listing) and skillsdirectory.com (manual form, reviewed) — both client-side forms, flagged for 2-minute human submission; claudeskills.info blocks automated access (403) |
+| 2026-06-10 | Topics extended to 18 (added skill-md, api-marketplace, kyc, company-data, e-invoicing, digital-signature, geocoding, italy) |