Donotify Voice Call Reminder

Send immediate voice call reminders or schedule future calls via DoNotify.

Security Scan

The skill's requirements and runtime instructions align with its stated purpose (sending/scheduling voice call reminders via DoNotify); nothing requested or instructed appears disproportionate or unrelated.

Purpose & Capability

Name/description (voice call reminders via DoNotify) match the declared requirements: an API token and a base URL plus outbound network permission. Those are exactly what a remote-notification integration would need.

Instruction Scope

SKILL.md confines behavior to three API interactions (usage, call-now, reminders) using the declared env vars. It does not instruct the agent to read local files, other environment variables, or contact third-party endpoints outside the configured DONOTIFY_URL.

Install Mechanism

Instruction-only skill with no install spec and no code files to write or execute; lowest-risk install posture. package.json exists but contains only metadata and a repository URL.

Credentials

Only DONOTIFY_API_TOKEN and DONOTIFY_URL are required, which is proportionate. Caution: DONOTIFY_URL is a configurable base URL — if set to an attacker-controlled host, the token could be sent to that host. Verify the URL points to the legitimate DoNotify service (default provided) and treat the API token as a secret with minimal scope.

Persistence & Privilege

Skill is not always:true, does not request elevated or persistent system privileges, and does not modify other skills' configs. Autonomous invocation is allowed (platform default) but not combined with other concerning privileges.

Assessment

This skill appears coherent for calling/scheduling reminders via DoNotify. Before installing or using it: (1) only provide DONOTIFY_API_TOKEN to this skill and keep it secret; (2) verify DONOTIFY_URL is the official DoNotify domain (default is https://donotifys.com) so your token isn't sent to an unexpected server; (3) confirm the token's scope/minimum privileges with the DoNotify service; and (4) if you want extra assurance, check the DoNotify project/repository and publisher to validate authenticity before supplying credentials.

DoNotify Skill

You can send immediate voice call reminders or schedule future calls through the DoNotify API.

Authentication

All requests require:

• Header: Authorization: Bearer $DONOTIFY_API_TOKEN
• Header: Accept: application/json
• Base URL: $DONOTIFY_URL (default: https://donotifys.com)

Endpoints

Check Usage

Check the user's plan, remaining notifications, and phone number status.

GET $DONOTIFY_URL/api/usage

Response:

{
  "plan": "starter",
  "notification_limit": 30,
  "used_this_month": 5,
  "remaining": 25,
  "phone_number_set": true
}

Before placing calls, check that phone_number_set is true and remaining is greater than 0. If the phone number is not set, tell the user to configure it in their DoNotify profile.

Call Now

Place an immediate voice call to the user's phone.

POST $DONOTIFY_URL/api/call-now
Content-Type: application/json

{
  "title": "Pick up groceries",
  "description": "Milk, eggs, bread from Trader Joe's"
}

Parameters:

• title (required, string, max 255) — What the call is about. This is spoken aloud.
• description (optional, string, max 1000) — Additional details spoken after the title.

Success response:

{
  "success": true,
  "reminder_id": 42,
  "call_uuid": "abc-123",
  "status": "completed"
}

Error response (422 if no phone number, 500 if call fails):

{
  "success": false,
  "reminder_id": 42,
  "error": "Phone number not configured. Update your profile first.",
  "status": "failed"
}

Schedule Reminder

Schedule a voice call for a future time.

POST $DONOTIFY_URL/api/reminders
Content-Type: application/json

{
  "title": "Team standup",
  "call_at": "2025-06-15T14:45:00Z",
  "description": "Prepare sprint update",
  "event_time": "2025-06-15T15:00:00Z"
}

Parameters:

• title (required, string, max 255) — Reminder title spoken in the call.
• call_at (required, ISO 8601 datetime, must be in the future) — When to place the call.
• description (optional, string, max 1000) — Extra details.
• event_time (optional, ISO 8601 datetime) — The actual event time, if different from call time.

Success response (201):

{
  "success": true,
  "reminder": {
    "id": 43,
    "title": "Team standup",
    "description": "Prepare sprint update",
    "call_at": "2025-06-15T14:45:00+00:00",
    "event_time": "2025-06-15T15:00:00+00:00",
    "status": "pending"
  }
}

Behavior Guidelines

• When the user says "call me now about X" or "remind me right now about X", use the Call Now endpoint.
• When the user says "remind me at [time] about X" or "call me at [time] for X", use the Schedule Reminder endpoint. Convert the user's natural language time to ISO 8601 for call_at.
• When the user asks "how many reminders do I have left" or "check my usage", use the Usage endpoint.
• Always check usage first if you're unsure whether the user has remaining notifications.
• If phone_number_set is false, tell the user to set their phone number at their DoNotify profile page before placing calls.
• Keep titles concise and descriptive — they are read aloud during the call.