ai-note-of-video

Generate AI-powered notes from videos (document, outline, or graphic-text formats)

Security Scan

The skill's declared API key and python requirement match its stated purpose, but the runtime instructions reference scripts that are not included and leave important details (how the API key is used, what the external domain is) unspecified, making the package incomplete and unclear.

Purpose & Capability

Name/description (generate notes from videos) aligns with requiring python3 and an API key for a third‑party service (SkillBoss). Requesting SKILLBOSS_API_KEY as the primary credential is proportionate to calling a remote API.

Instruction Scope

SKILL.md instructs the agent to run python scripts (scripts/ai_notes_task_create.py, scripts/ai_notes_poll.py, etc.) and to POST to https://api.heybossai.com/v1/pilot, but no code files are bundled. The instructions do not show how the SKILLBOSS_API_KEY is included in requests (headers, env var usage), and leave the implementation details to unspecified scripts—this is incomplete and grants broad implicit discretion to any scripts that might be supplied later.

Install Mechanism

No install spec is provided (instruction-only), so nothing is written to disk by the skill installer. This is lower-risk, but since the runtime relies on external scripts that are not included, the package is effectively unusable as-is.

Credentials

Only SKILLBOSS_API_KEY is required and marked primary, which is appropriate for a remote-API integration. However, the SKILL.md doesn't demonstrate how the key is used or what scopes/permissions the API key requires—users should confirm the key's intended scope and ensure no additional unrelated credentials are requested.

Persistence & Privilege

The skill is not marked always:true and does not request system-wide config paths or persistent modification. Autonomous invocation is allowed (platform default) but not combined with other high-privilege flags.

What to consider before installing

This package looks incomplete: the README expects Python scripts under a scripts/ directory but none are bundled. Before installing or providing your SKILLBOSS_API_KEY, ask the publisher for the missing scripts or for the HTTP request examples that show how the API key is sent (authorization header, bearer token, etc.). Verify the external domain (api.heybossai.com) and its privacy policy—ensure you're comfortable uploading video URLs/content to that service. Do not provide unrelated credentials. If you receive the scripts later, review them to ensure they only call the declared API endpoint, do not read local files or other environment variables, and handle secrets safely (only use the declared SKILLBOSS_API_KEY).

AI Video Notes

Generate structured notes from video URLs using SkillBoss API Hub. Supports three note formats.

Workflow

1. Generate Notes: Submit video URL → get structured notes synchronously via SkillBoss API Hub

Note Types

Type	Description
1	Document notes
2	Outline notes
3	Graphic-text notes

APIs

Generate Notes

Endpoint: POST https://api.heybossai.com/v1/pilot

Parameters:

• video_url (required): Public video URL

Example:

python3 scripts/ai_notes_task_create.py 'https://example.com/video.mp4'

Response:

{
  "status": "success",
  "notes": "Generated notes content..."
}

Query Notes

Endpoint: POST https://api.heybossai.com/v1/pilot

Parameters:

• video_url (required): Public video URL (SkillBoss API Hub returns results synchronously)

Example:

python3 scripts/ai_notes_task_query.py "https://example.com/video.mp4"

Response (Completed):

{
  "notes": "Document notes...\nOutline notes...\nGraphic-text notes..."
}

Polling Strategy

Option 1: Manual Query

1. Call the create script directly with video URL
2. Notes are returned synchronously:

   python3 scripts/ai_notes_task_create.py <video_url>
   

Option 2: Auto Query (Recommended)

Use the poll script for automatic note generation:

python3 scripts/ai_notes_poll.py <video_url> [max_attempts] [interval_seconds]

Examples:

# Default settings
python3 scripts/ai_notes_poll.py "https://example.com/video.mp4"

# Custom: 30 attempts, 5-second intervals
python3 scripts/ai_notes_poll.py "https://example.com/video.mp4" 30 5

Output:

• Returns formatted notes with type labels upon completion

Error Handling

• Invalid URL: "Video URL not accessible"
• Processing error: "Failed to parse video"
• Timeout: "Video too long, try again later"