How do I install the Perpetua skill?

Run npx skillmds@latest add dvcrn/perpetua in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Perpetua safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Perpetua?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Perpetua free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Perpetua?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Perpetua by dvcrn — Agent Skill

Name: Perpetua
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

Perpetua Skill (Hosted)

Overview

Use Perpetua.sh hosted API as the default path:

Base URL: https://www.perpetua.sh
API routes: /api/*
Auth: Authorization: Bearer $PERPETUA_API_KEY

Load secrets with:

op run --env-file="$HOME/.openclaw/secrets.env" -- <command>

Credentials

Set API key via env var from any secret source (1Password, CI, .env, secret manager):

export PERPETUA_API_KEY="<your-key>"

Core endpoints (hosted)

# Connection status summary
curl -s "https://www.perpetua.sh/api/status" \
  -H "Authorization: Bearer $PERPETUA_API_KEY"

# Active connections
curl -s "https://www.perpetua.sh/api/connections" \
  -H "Authorization: Bearer $PERPETUA_API_KEY"

# Providers
curl -s "https://www.perpetua.sh/api/providers" \
  -H "Authorization: Bearer $PERPETUA_API_KEY"

Proxy call pattern

GET https://www.perpetua.sh/api/proxy/:provider/:path
Authorization: Bearer $PERPETUA_API_KEY

Optional: ?account=default for explicit account selection.

Oura examples

Avoid huge endpoints (daily_activity, detailed sleep) unless explicitly needed.

# Daily sleep
curl -s "https://www.perpetua.sh/api/proxy/oura/v2/usercollection/daily_sleep?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD&account=default" \
  -H "Authorization: Bearer $PERPETUA_API_KEY" | jq .

# Daily readiness
curl -s "https://www.perpetua.sh/api/proxy/oura/v2/usercollection/daily_readiness?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD&account=default" \
  -H "Authorization: Bearer $PERPETUA_API_KEY" | jq .

# Workout
curl -s "https://www.perpetua.sh/api/proxy/oura/v2/usercollection/workout?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD&account=default" \
  -H "Authorization: Bearer $PERPETUA_API_KEY" | jq .

Google Calendar examples

# Upcoming primary calendar events
curl -s "https://www.perpetua.sh/api/proxy/gcal/calendars/primary/events?account=default&maxResults=10&orderBy=startTime&singleEvents=true&timeMin=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
  -H "Authorization: Bearer $PERPETUA_API_KEY" | jq '[.items[] | {summary, start}]'

# Calendar list
curl -s "https://www.perpetua.sh/api/proxy/gcal/users/me/calendarList?account=default" \
  -H "Authorization: Bearer $PERPETUA_API_KEY" | jq .

Connection management (hosted)

# Start OAuth flow for provider
curl -s -X POST "https://www.perpetua.sh/api/auth/connect/:provider/start" \
  -H "Authorization: Bearer $PERPETUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account":"default"}' | jq .authUrl

Troubleshooting

401 → wrong/expired API key
403/404 on provider routes → missing connection or wrong provider/account
5xx → hosted service issue; retry and/or notify Daniel

Local OSS note

Local http://localhost:3001 is for OSS development only. Default operational path in this workspace is hosted Perpetua.sh.

---name: perpetuadescription: OAuth proxy for calling external APIs (Oura, Google Calendar, etc.) via Perpetua.sh hosted API using a single API key. Use when fetching Oura data, Google Calendar events, or managing OAuth connections.---# Perpetua Skill (Hosted)## OverviewUse **Perpetua.sh hosted API** as the default path:- Base URL: `https://www.perpetua.sh`- API routes: `/api/*`- Auth: `Authorization: Bearer $PERPETUA_API_KEY`Load secrets with:```bashop run --env-file="$HOME/.openclaw/secrets.env" -- <command>```## CredentialsSet API key via env var from any secret source (1Password, CI, `.env`, secret manager):```bashexport PERPETUA_API_KEY="<your-key>"```## Core endpoints (hosted)```bash# Connection status summarycurl -s "https://www.perpetua.sh/api/status" \ -H "Authorization: Bearer $PERPETUA_API_KEY"# Active connectionscurl -s "https://www.perpetua.sh/api/connections" \ -H "Authorization: Bearer $PERPETUA_API_KEY"# Providerscurl -s "https://www.perpetua.sh/api/providers" \ -H "Authorization: Bearer $PERPETUA_API_KEY"```## Proxy call pattern```bashGET https://www.perpetua.sh/api/proxy/:provider/:pathAuthorization: Bearer $PERPETUA_API_KEY```Optional: `?account=default` for explicit account selection.### Oura examples> Avoid huge endpoints (`daily_activity`, detailed `sleep`) unless explicitly needed.```bash# Daily sleepcurl -s "https://www.perpetua.sh/api/proxy/oura/v2/usercollection/daily_sleep?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD&account=default" \ -H "Authorization: Bearer $PERPETUA_API_KEY" | jq .# Daily readinesscurl -s "https://www.perpetua.sh/api/proxy/oura/v2/usercollection/daily_readiness?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD&account=default" \ -H "Authorization: Bearer $PERPETUA_API_KEY" | jq .# Workoutcurl -s "https://www.perpetua.sh/api/proxy/oura/v2/usercollection/workout?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD&account=default" \ -H "Authorization: Bearer $PERPETUA_API_KEY" | jq .```### Google Calendar examples```bash# Upcoming primary calendar eventscurl -s "https://www.perpetua.sh/api/proxy/gcal/calendars/primary/events?account=default&maxResults=10&orderBy=startTime&singleEvents=true&timeMin=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \ -H "Authorization: Bearer $PERPETUA_API_KEY" | jq '[.items[] | {summary, start}]'# Calendar listcurl -s "https://www.perpetua.sh/api/proxy/gcal/users/me/calendarList?account=default" \ -H "Authorization: Bearer $PERPETUA_API_KEY" | jq .```## Connection management (hosted)```bash# Start OAuth flow for providercurl -s -X POST "https://www.perpetua.sh/api/auth/connect/:provider/start" \ -H "Authorization: Bearer $PERPETUA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"account":"default"}' | jq .authUrl```## Troubleshooting- `401` → wrong/expired API key- `403/404` on provider routes → missing connection or wrong provider/account- `5xx` → hosted service issue; retry and/or notify Daniel## Local OSS noteLocal `http://localhost:3001` is for OSS development only. Default operational path in this workspace is hosted Perpetua.sh.

Frequently asked questions

Perpetua