# rskills.ai — ROS2 Skills for Humanoid Robots

> Verified ROS2 skill registry for humanoid and industrial robots.
> Skills are behavior packages (SKILL.md + manifest) installable via CLI
> or API. Verification levels: L1 (auto-tested), L2 (peer-reviewed),
> L3 (certified).

## Machine access (for AI agents)

- Registry search (no key, 100 req/day/IP): GET https://rskills.ru/api/v1/registry/skills?q=&robot=&ros2_distro=
- Skill by slug: GET https://rskills.ru/api/v1/registry/skills/{slug}
- Download package: GET https://rskills.ru/api/v1/registry/skills/{slug}/download
- Leaderboard: GET https://rskills.ru/api/v1/registry/top
- Trending (7d installs): GET https://rskills.ru/api/v1/registry/trending
- Full skill list: https://rskills.ru/llms-full.txt
- OpenAPI schema: https://rskills.ru/api/v1/openapi.json
- Install badge: https://rskills.ru/api/v1/registry/b/{slug}.svg

## API keys (higher limits, paid content)

Register a user, then POST https://rskills.ru/api/v1/apikeys with JWT Bearer token
to obtain an `rsk_...` key. Pass it as `X-API-Key: rsk_...`.
Plans and prices: GET https://rskills.ru/api/v1/billing/plans
Commercial skills require a PRO/ENTERPRISE key (402 otherwise).

## CLI

  pip install rskills-cli   # or: cli/rskills from the repo (stdlib only)
  rskills search welding
  rskills add <slug>        # auto-detects ROS2 distro, installs to workspace

## Pages

- Home: https://rskills.ru/
- Free skills: https://rskills.ru/free
- Skill page: https://rskills.ru/skills/{id}
- Docs / Swagger: https://rskills.ru/api/v1/docs