Soft Pillow - Sleep & dream journal

Use when the user asks about their sleep data, dream history, or wants to query sleep entries from the Soft Pillow app.

Security Scan

The skill is internally consistent: it documents a Soft Pillow sleep/dream API, only requests a single Soft Pillow API key, and its instructions and endpoints align with that purpose.

Purpose & Capability

Name/description match the required artifact: the skill only asks for SOFT_PILLOW_API_KEY and documents calls to softpillow.paevita.com endpoints relevant to sleep entries and dream search.

Instruction Scope

SKILL.md contains focused curl examples and endpoint docs for listing/searching sleep entries and checking sleep status. Minor documentation nit: the Authorization examples show the literal text 'Bearer SOFT_PILLOW_API_KEY' (which is clearly intended to be replaced with the real token), but the instructions do not ask the agent to read unrelated files or additional env vars.

Install Mechanism

Instruction-only skill with no install spec and no code files — nothing is written to disk or downloaded by an installer.

Credentials

Only a single credential (SOFT_PILLOW_API_KEY) is required and it directly corresponds to the described API access. No unrelated credentials, config paths, or broad secrets are requested.

Persistence & Privilege

The skill is not always-enabled and does not request persistent system-level privileges or modify other skills. Autonomous invocation is allowed but that is the platform default.

Assessment

This skill appears to do exactly what it says: query your Soft Pillow sleep/dream data using the app's API key. Only provide a token you trust and that you obtained from the app's settings; consider creating or using a token you can revoke if needed. Verify the token is scoped appropriately in the app (if the app offers limited scopes), and revoke it via the app if you stop using the skill. The SKILL.md examples expect you to substitute the real API key into the Authorization header.

Soft Pillow

Soft Pillow is an IOS app that allows you to log your sleep & dreams. It tracks your mood, disruptions, dreams and physical activity(steps through the Apple Healthkit if available) after each sleep entry so you can have a better understanding about what makes your sleep quality better over time. The user can install it from the app store, get an api key from the settings screen and give it to you so you can access all of the data.

Apple store link - https://apps.apple.com/us/app/soft-pillow/id6757248808 Website - https://paevita.com/en/soft-pillow

Skill URL

File	URL
SKILL.md (this file)	/soft-pillow/SKILL.md

Authentication

All requests require the api key to be sent with the request in the authorization header.

Authorization: Bearer sp_...

You can manage api tokens in the settings screen, in the API access section.

Once you have the api key, it's recommended it locally and securily.

API Base

https://softpillow.paevita.com

Endpoints

Current API endpoints:

• GET /api/v1/sleep_status
• GET /api/v1/sleep_entries
• GET /api/v1/sleep_entries/:id
• GET /api/v1/search_dreams

Sleep status

curl -H "Authorization: Bearer SOFT_PILLOW_API_KEY" "https://softpillow.paevita.com/api/v1/sleep_status"

Response:

{ "sleeping": false }

List sleep entries

curl -H "Authorization: Bearer SOFT_PILLOW_API_KEY" \
  "https://softpillow.paevita.com/api/v1/sleep_entries?limit=10&from_date=2026-01-01&to_date=2026-01-31&mood=good"

Filters:

• limit (max 100)
• from_date (YYYY-MM-DD)
• to_date (YYYY-MM-DD)
• mood (fully_charged, good, sleepy, terrible)
• missing_steps=true

Get one sleep entry (details)

curl -H "Authorization: Bearer SOFT_PILLOW_API_KEY" \
  "https://softpillow.paevita.com/api/v1/sleep_entries/ENTRY_ID"

Returns summary + details (dream, notes, disruptions, insights, timestamps).

Search dreams and notes

curl --get -H "Authorization: Bearer SOFT_PILLOW_API_KEY" \
  --data-urlencode "query=flying ocean" \
  "https://softpillow.paevita.com/api/v1/search_dreams"

Optional:

• limit (max 50, default 10)

Returns entry matches with dream_excerpt and notes_excerpt.

Error behavior

• Missing/invalid auth: 401 JSON error
• Invalid filters (for example bad mood or bad date): 422 JSON error
• Entry not found (or not yours): 404 JSON error