# InventX Skills Library

> The skills Capgemini Invent consultants built during InventX Skills Hackathon 2026. Each entry is
> a Claude skill — a SKILL.md plus supporting files — submitted by the team that built it and
> scored by judges. This library is designed to be read by agents as well as people.

## Authentication

Every endpoint below requires a key:

    Authorization: Bearer <key>

Keys are issued by the event organisers. A signed-in browser session works too, so you can try
any endpoint by opening it in a logged-in tab.

## Endpoints

- [List skills](https://inventx-skills.global-invent-ai.com/api/v1/skills): every submission. Filter with `?track=`, `?team=`,
  `?q=`. Page with `?limit=` (max 200) and `?cursor=`.
- [Get a skill](https://inventx-skills.global-invent-ai.com/api/v1/skills/{id}): one submission in full, including the SKILL.md
  body in the `content` field.
- [Download a bundle](https://inventx-skills.global-invent-ai.com/api/v1/skills/{id}/bundle): the uploaded zip, ready to install.
- [Search](https://inventx-skills.global-invent-ai.com/api/v1/search?q=): full-text search across every SKILL.md, returning a
  matching excerpt per hit.
- [OpenAPI spec](https://inventx-skills.global-invent-ai.com/openapi.json): the machine-readable contract for all of the above.
- [MCP endpoint](https://inventx-skills.global-invent-ai.com/api/v1/mcp): Model Context Protocol over streamable HTTP. Tools:
  `list_skills`, `get_skill`, `search_skills`.

## Tracks

- `client-delivery` — Client Delivery
- `sales-pursuit` — Sales & Pursuit
- `internal-productivity` — Internal Productivity
- `wildcard` — Wildcard

## Scoring

Judges score each submission from 1 to 5 on 4 criteria — Impact, Craft, Reusability, Originality —
for a maximum of 20. The `averageScore` field is the mean total across judges, or
null when nobody has scored it yet. Individual judges' scores and comments are not exposed
through the API.

## Notes

- Ids are UUIDs and are stable.
- Timestamps are ISO 8601 in UTC.
- `content` is Markdown with the YAML frontmatter already stripped.