# Resources

## Public repositories

| Repository | What it holds | Source in the monorepo |
| --- | --- | --- |
| [portpowered/portos-docs](https://github.com/portpowered/portos-docs) | Customer guides and agent skills as plain Markdown | `docs/skills/` and `docs/user-guides/`, exported by `scripts/exportPublicDocs.mjs` |
| [portpowered/portos-plugin](https://github.com/portpowered/portos-plugin) | The Port OS plugin for Claude and other AI clients: the hosted MCP connection plus skills | `plugins/portos/`, built by `scripts/buildAssistantPlugins.mjs` |
| [portpowered/portos-reference-data](https://github.com/portpowered/portos-reference-data) | The public OpenAPI schema, capability catalog and agent documentation | `packages/reference-data/` |
| [portpowered/index](https://github.com/portpowered/index) | The index of everything Port OS publishes | Not in the monorepo. `index.json` is the source and `node scripts/render.mjs` renders the README. |

## Packages

| Package | Registry | Source |
| --- | --- | --- |
| [`@portpowered/reference-data`](https://www.npmjs.com/package/@portpowered/reference-data) | npm | [portpowered/portos-reference-data](https://github.com/portpowered/portos-reference-data) |
| [`github.com/portpowered/portos-reference-data`](https://pkg.go.dev/github.com/portpowered/portos-reference-data) | Go module | [portpowered/portos-reference-data](https://github.com/portpowered/portos-reference-data) |

## Schemas

| Schema | File | What it describes |
| --- | --- | --- |
| OpenAPI schema | [openapi.yaml](https://portoperatingsystem.com/openapi.yaml) | Every public REST operation, with its parameters, request bodies and responses |
| Capability interface schemas | [capability-interfaces.yaml](https://portoperatingsystem.com/docs/references/capability-interfaces.yaml) | The index of every capability interface. Each entry links to its schema file, for example [`power` 1.0](https://portoperatingsystem.com/docs/references/capability-interfaces/power/1.0.yaml) |

## MCP endpoint

| Endpoint | Transport |
| --- | --- |
| `https://api.portoperatingsystem.com/mcp` | Streamable HTTP, OAuth sign-in required |

## Agent skills

| Skill | Installable file |
| --- | --- |
| `add-devices` | [skills/setup/add-devices/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/setup/add-devices/SKILL.md) |
| `cameras` | [skills/devices/cameras/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/devices/cameras/SKILL.md) |
| `cloud-drives` | [skills/devices/cloud-drives/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/devices/cloud-drives/SKILL.md) |
| `connect-google-nest` | [skills/setup/connect-google-nest/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/setup/connect-google-nest/SKILL.md) |
| `connect-smartthings` | [skills/setup/connect-smartthings/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/setup/connect-smartthings/SKILL.md) |
| `connect-spotify` | [skills/setup/connect-spotify/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/setup/connect-spotify/SKILL.md) |
| `connected-home` | [skills/general/connected-home/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/general/connected-home/SKILL.md) |
| `first-setup` | [skills/setup/first-setup/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/setup/first-setup/SKILL.md) |
| `grant-endpoint-permissions` | [skills/general/grant-endpoint-permissions/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/general/grant-endpoint-permissions/SKILL.md) |
| `kitchen` | [skills/devices/kitchen/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/devices/kitchen/SKILL.md) |
| `lighting` | [skills/devices/lighting/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/devices/lighting/SKILL.md) |
| `manage-devices` | [skills/general/manage-devices/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/general/manage-devices/SKILL.md) |
| `manage-groups` | [skills/general/manage-groups/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/general/manage-groups/SKILL.md) |
| `manage-simulators` | [skills/general/manage-simulators/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/general/manage-simulators/SKILL.md) |
| `media` | [skills/devices/media/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/devices/media/SKILL.md) |
| `model-inference` | [skills/devices/model-inference/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/devices/model-inference/SKILL.md) |
| `reminders-and-calendars` | [skills/devices/reminders-and-calendars/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/devices/reminders-and-calendars/SKILL.md) |
| `security` | [skills/devices/security/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/devices/security/SKILL.md) |
| `sensors` | [skills/devices/sensors/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/devices/sensors/SKILL.md) |
| `sign-in-and-connect-accounts` | [skills/setup/sign-in-and-connect-accounts/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/setup/sign-in-and-connect-accounts/SKILL.md) |
| `sign-in-with-access-key` | [skills/setup/sign-in-with-access-key/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/setup/sign-in-with-access-key/SKILL.md) |
| `thermostats` | [skills/devices/thermostats/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/devices/thermostats/SKILL.md) |
| `trackers` | [skills/devices/trackers/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/devices/trackers/SKILL.md) |
| `troubleshoot-connections` | [skills/general/troubleshoot-connections/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/general/troubleshoot-connections/SKILL.md) |
| `vacuums` | [skills/devices/vacuums/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/devices/vacuums/SKILL.md) |
| `verify-connection-light` | [skills/setup/verify-connection-light/SKILL.md](https://github.com/portpowered/portos-docs/blob/main/skills/setup/verify-connection-light/SKILL.md) |