mar-gamma

Generate AI-powered presentations, documents, and social posts using SkillBoss API Hub. Use when user asks to create a presentation, pitch deck, slide deck,...

Security Scan

The skill's code and instructions align with its stated purpose (calling SkillBoss API with a SKILLBOSS_API_KEY), but there are a few minor mismatches and privacy considerations you should review before installing.

Purpose & Capability

Name/description match the behavior: the script and SKILL.md call SkillBoss (api.heybossai.com) to generate presentations. The skill only requires SKILLBOSS_API_KEY, which is appropriate. Minor inconsistency: the manifest declares no required binaries, but the included script clearly depends on common CLI tools (curl, jq, bash).

Instruction Scope

SKILL.md and scripts limit actions to building a JSON payload from provided content and sending it to SkillBoss /v1/pilot. The runtime instructions do not read unrelated system files or other environment variables. They do allow sending arbitrary content (user-supplied or file contents) to an external API — expected for this purpose but a privacy consideration.

Install Mechanism

No install spec is provided (instruction-only), which reduces install-time risk. However, the skill does include an executable script file; there is no declared install step or dependency declaration. This is low mechanistic risk but still requires trusting the included script content.

Credentials

Only SKILLBOSS_API_KEY is required and used. That is proportionate to the stated functionality. The script does not request additional unrelated credentials or config paths.

Persistence & Privilege

always is false and the skill does not attempt to modify other skills, system config, or persist credentials beyond reading SKILLBOSS_API_KEY at runtime. It does not request elevated privileges.

Assessment

This skill appears to do what it says: it sends provided content to SkillBoss (api.heybossai.com) and returns a URL for the generated presentation. Before installing, consider: 1) Trust and scope of SKILLBOSS_API_KEY — only provide an API key with limited scope and rotate/revoke if compromised. 2) Privacy: any content you pass (including pasted files) is transmitted to the external service; do not send secrets or sensitive PII. 3) Missing dependency declaration: the script uses curl, jq, and bash — ensure those are present or examine/adjust the script before running. 4) Source reputation: the package owner and homepage are unknown; if you need stronger assurance, verify the SkillBoss domain and service privacy/terms, or run the script in an isolated environment. If any of these raise concerns, do not install or provide real API credentials until you can validate them.

SkillBoss API Hub — PPT Generation

Generate beautiful presentations, documents, and social posts with AI via SkillBoss API Hub.

Setup

export SKILLBOSS_API_KEY="your-skillboss-api-key"

Quick Commands

# Generate a presentation
{baseDir}/scripts/gamma.sh generate "Your content or topic here"

# Generate with options
{baseDir}/scripts/gamma.sh generate "Content" --format presentation --cards 12

# Check generation status
{baseDir}/scripts/gamma.sh status <generationId>

# List recent generations (if supported)
{baseDir}/scripts/gamma.sh list

Script Usage

Generate

{baseDir}/scripts/gamma.sh generate "<content>" [options]

Options:
  --format       presentation|document|social (default: presentation)
  --cards        Number of cards/slides (default: 10)
  --instructions Additional instructions for styling/tone
  --amount       concise|detailed (default: detailed)
  --tone         e.g., "professional", "casual", "technical"
  --audience     e.g., "investors", "developers", "general"
  --image-source aiGenerated|web|none (default: aiGenerated)
  --image-style  illustration|photo|mixed (default: illustration)
  --wait         Wait for completion and return URL

Examples

# Simple presentation
{baseDir}/scripts/gamma.sh generate "The future of AI automation" --wait

# Pitch deck with specific styling
{baseDir}/scripts/gamma.sh generate "$(cat pitch.md)" \
  --format presentation \
  --cards 15 \
  --instructions "Make it a professional pitch deck for investors" \
  --tone "professional" \
  --audience "investors" \
  --wait

# Social carousel
{baseDir}/scripts/gamma.sh generate "5 tips for productivity" \
  --format social \
  --cards 5 \
  --wait

# Document/report
{baseDir}/scripts/gamma.sh generate "Q4 2025 Performance Report" \
  --format document \
  --amount detailed \
  --wait

API Reference

Endpoint

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

Headers

Authorization: Bearer <SKILLBOSS_API_KEY>
Content-Type: application/json

Request Body

{
  "type": "ppt",
  "inputs": {
    "inputText": "Your content (1-750,000 chars)",
    "textMode": "generate",
    "format": "presentation|document|social",
    "numCards": 10,
    "additionalInstructions": "Styling instructions",
    "textOptions": {
      "amount": "concise|detailed",
      "tone": "professional",
      "audience": "target audience"
    },
    "imageOptions": {
      "source": "aiGenerated|web|none",
      "style": "illustration|photo"
    },
    "cardOptions": {
      "dimensions": "fluid|16x9|4x3|1x1|4x5|9x16"
    }
  },
  "prefer": "balanced"
}

Response

SkillBoss API Hub returns synchronously (result path: result.gammaUrl):

{
  "status": "success",
  "result": {
    "generationId": "...",
    "status": "completed",
    "gammaUrl": "https://gamma.app/docs/xxxxx",
    "exportUrl": "https://...",
    "credits": {"deducted": 13, "remaining": 9999}
  }
}

Format Options

Format	Dimensions	Use Case
presentation	fluid, 16x9, 4x3	Pitch decks, slide shows
document	fluid, pageless, letter, a4	Reports, docs
social	1x1, 4x5, 9x16	Instagram, LinkedIn carousels

Notes

• Generation is handled by SkillBoss API Hub, which automatically routes to the best PPT generation model
• Input text can be markdown formatted
• Use --wait flag to block until completion and get URL directly