Skip to content

Commit d63a076

Browse files
francescobiancofrancescobianco
committed
ci(repo): branded README header, Skills CI workflow with validation and bundle artifacts, distribution log update
1 parent 3e97922 commit d63a076

5 files changed

Lines changed: 148 additions & 6 deletions

File tree

‎.github/assets/images/repo-header-a4.png‎

177 KB
Loading

‎.github/assets/images/repo-header-a4.txt‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
Image Description Sheet
2+
-----------------------
3+
4+
File Name: repo-header-a4.png
5+
Format: PNG
6+
Dimensions: 830 x 173 pixels
7+
8+
Short Description:
9+
A banner image featuring the word "Openapi" on the left, Various tech figures in the background,
10+
and the Openapi logo on the right.
11+
12+
Purpose:
13+
This image is intended to be used as a header/banner for documentation or repository README.
14+
It visually associates linux tools with the Openapi CLI,
15+
giving a professional and modern look to the project materials.

‎.github/workflows/skills.yml‎

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
name: Skills CI
2+
3+
on:
4+
push:
5+
branches: [main]
6+
tags: ['v*']
7+
pull_request:
8+
branches: [main]
9+
workflow_dispatch:
10+
11+
jobs:
12+
validate:
13+
name: Validate skills
14+
runs-on: ubuntu-latest
15+
steps:
16+
- uses: actions/checkout@v4
17+
18+
- name: Lint SKILL.md files
19+
run: bash test/validate_skills.sh
20+
21+
build:
22+
name: Build skill bundles
23+
needs: validate
24+
runs-on: ubuntu-latest
25+
steps:
26+
- uses: actions/checkout@v4
27+
28+
- name: Package each skill and the full bundle
29+
run: |
30+
mkdir -p dist
31+
for skill in skills/*/; do
32+
name="$(basename "$skill")"
33+
(cd skills && zip -qr "../dist/${name}.zip" "$name")
34+
done
35+
zip -qr dist/openapi-skills-all.zip skills
36+
ls -la dist/
37+
38+
- name: Upload artifacts
39+
uses: actions/upload-artifact@v4
40+
with:
41+
name: openapi-skills
42+
path: dist/
43+
retention-days: 30
44+
45+
release-assets:
46+
name: Attach bundles to release
47+
if: startsWith(github.ref, 'refs/tags/v')
48+
needs: validate
49+
runs-on: ubuntu-latest
50+
permissions:
51+
contents: write
52+
steps:
53+
- uses: actions/checkout@v4
54+
55+
- name: Package skills
56+
run: |
57+
mkdir -p dist
58+
for skill in skills/*/; do
59+
name="$(basename "$skill")"
60+
(cd skills && zip -qr "../dist/${name}.zip" "$name")
61+
done
62+
zip -qr dist/openapi-skills-all.zip skills
63+
64+
- name: Upload to release
65+
run: gh release upload "$GITHUB_REF_NAME" dist/*.zip --clobber
66+
env:
67+
GH_TOKEN: ${{ github.token }}

‎DISTRIBUTION.md‎

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -39,10 +39,10 @@ Fork → add entry in the right section → PR. One PR per list, link `https://g
3939

4040
| List | URL | Status | Date | Notes |
4141
|---|---|---|---|---|
42-
| VoltAgent/awesome-agent-skills | https://github.com/VoltAgent/awesome-agent-skills | todo | | Largest community list (1000+ skills) |
43-
| heilcheng/awesome-agent-skills | https://github.com/heilcheng/awesome-agent-skills | todo | | Focus on skills used by real engineering teams |
44-
| ComposioHQ/awesome-claude-skills | https://github.com/ComposioHQ/awesome-claude-skills | todo | | |
45-
| travisvn/awesome-claude-skills | https://github.com/travisvn/awesome-claude-skills | todo | | |
42+
| VoltAgent/awesome-agent-skills | https://github.com/VoltAgent/awesome-agent-skills | todo | | **Deferred**: their CONTRIBUTING requires real community usage — "brand new skills are not accepted". Re-try once installs/stars accrue (≥1–2 months) |
43+
| heilcheng/awesome-agent-skills | https://github.com/heilcheng/awesome-agent-skills | submitted | 2026-06-10 | PR [#276](https://github.com/heilcheng/awesome-agent-skills/pull/276): "Skills by Openapi" block under Business, Productivity & Marketing, with team-affiliation disclosure |
44+
| ComposioHQ/awesome-claude-skills | https://github.com/ComposioHQ/awesome-claude-skills | n/a | 2026-06-10 | Hosts skills *inside* its own repo (folders, not links) — not a fit for linking an external collection |
45+
| travisvn/awesome-claude-skills | https://github.com/travisvn/awesome-claude-skills | todo | | **At-risk**: strict "no SaaS wrappers / no promotion" policy for skills requiring the submitter's paid platform. If submitted, be transparent and target the "Collections & Libraries" section |
4646
| hesreallyhim/awesome-claude-code | https://github.com/hesreallyhim/awesome-claude-code | todo | | General Claude Code list — skills section |
4747
| ComposioHQ/awesome-claude-plugins | https://github.com/ComposioHQ/awesome-claude-plugins | todo | | If/when packaged as plugin |
4848
| Chat2AnyLLM/awesome-claude-plugins | https://github.com/Chat2AnyLLM/awesome-claude-plugins | todo | | If/when packaged as plugin |
@@ -113,3 +113,6 @@ Not this repo, but the same audience: each MCP listing should cross-link the ski
113113
| 2026-06-10 | Repo metadata set: description, homepage, 7 topics (`gh repo edit`) |
114114
| 2026-06-10 | Release v0.1.0 published with install instructions |
115115
| 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) |
116+
| 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) |
117+
| 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) |
118+
| 2026-06-10 | Repo polish: branded README header, Skills CI workflow (lint + zip bundles + release assets) |

‎README.md‎

Lines changed: 59 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,25 @@
1-
# openapi-skills
1+
<div align="center">
2+
<a href="https://openapi.com/">
3+
<img alt="Openapi Skills" src=".github/assets/images/repo-header-a4.png" >
4+
</a>
5+
6+
<h1>🧩 Openapi® Skills</h1>
7+
<h4>Agent skills to interact with <a href="https://openapi.com/">Openapi®</a> APIs from Claude Code and any SKILL.md-compatible agent</h4>
8+
9+
[![Skills CI](https://github.com/openapi/openapi-skills/actions/workflows/skills.yml/badge.svg)](https://github.com/openapi/openapi-skills/actions/workflows/skills.yml)
10+
[![Release](https://img.shields.io/github/v/release/openapi/openapi-skills)](https://github.com/openapi/openapi-skills/releases)
11+
[![License](https://img.shields.io/github/license/openapi/openapi-skills)](LICENSE)
12+
[![Skills](https://img.shields.io/badge/skills-11-blueviolet)](skills/)
13+
<br>
14+
[![Linux Foundation Member](https://img.shields.io/badge/Linux%20Foundation-Silver%20Member-003778?logo=linux-foundation&logoColor=white)](https://www.linuxfoundation.org/about/members)
15+
</div>
216

317
Agent skills for using and integrating the services of the [Openapi](https://openapi.com) API marketplace — the largest certified API marketplace in Europe.
418

19+
```bash
20+
npx skills add openapi/openapi-skills
21+
```
22+
523
## Repository layout
624

725
| Folder | Purpose |
@@ -37,4 +55,43 @@ Maintenance flow: update `knowledge/` from the official sources first, then prop
3755

3856
## Credentials
3957

40-
Skills expect `OPENAPI_EMAIL` and `OPENAPI_API_KEY` (account credentials for `oauth.openapi.com`) and/or a ready-made `OPENAPI_TOKEN` Bearer token in the environment. See [knowledge/platform-guide.md](knowledge/platform-guide.md).
58+
Skills expect `OPENAPI_EMAIL` and `OPENAPI_API_KEY` (account credentials for `oauth.openapi.com`) and/or a ready-made `OPENAPI_TOKEN` Bearer token in the environment. See [knowledge/platform-guide.md](knowledge/platform-guide.md).
59+
60+
## Contributing
61+
62+
Contributions are always welcome! Whether you want to report bugs, suggest new features, improve documentation, or contribute code, your help is appreciated.
63+
64+
## Authors
65+
66+
- Francesco Bianco ([@francescobianco](https://www.github.com/francescobianco))
67+
- Openapi Team ([@openapi-it](https://github.com/openapi-it))
68+
69+
## Partners
70+
71+
Meet our partners using Openapi or contributing to this project:
72+
73+
- [Blank](https://www.blank.app/)
74+
- [Credit Safe](https://www.creditsafe.com/)
75+
- [Deliveroo](https://deliveroo.it/)
76+
- [Gruppo MOL](https://molgroupitaly.it/it/)
77+
- [Jakala](https://www.jakala.com/)
78+
- [Octotelematics](https://www.octotelematics.com/)
79+
- [OTOQI](https://otoqi.com/)
80+
- [PWC](https://www.pwc.com/)
81+
- [QOMODO S.R.L.](https://www.qomodo.me/)
82+
- [SOUNDREEF S.P.A.](https://www.soundreef.com/)
83+
84+
## Our Commitments
85+
86+
We believe in open source and we act on that belief. We became Silver Members
87+
of the Linux Foundation because we wanted to formally support the ecosystem
88+
we build on every day. Open standards, open collaboration, and open governance
89+
are part of how we work and how we think about software.
90+
91+
## License
92+
93+
This project is licensed under the [MIT License](LICENSE).
94+
95+
The MIT License is a permissive open-source license that allows you to freely use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software, provided that the original copyright notice and this permission notice are included in all copies or substantial portions of the software.
96+
97+
For more details, see the full license text at the [MIT License page](https://choosealicense.com/licenses/mit/).

0 commit comments

Comments
 (0)