Executing Scripts

Run skill scripts in the cloud or locally — your agent handles the details.

Two Ways to Run Scripts

When a skill has scripts, your agent can run them in the cloud or download and execute them on your machine. Each has trade-offs.

Cloud Execution

Recommended

Scripts run in an isolated cloud sandbox. Faster, safer, and no local setup required. Dependencies are pre-installed automatically.

CostCredits per execution (5-min or 30-min sessions)

SpeedFast — optimized containers with cached dependencies

SafetyFully isolated, destroyed after use

Best forMost tasks — data processing, file conversion, analysis

Local Execution

Free

Your agent downloads the script and runs it on your machine. Free, but requires local dependencies and runs with your system permissions.

CostFree — no credits charged

SetupYou manage dependencies (Python, pip packages, etc.)

SafetyRuns on your machine with your permissions

Best forFile uploads, local tools, cost-sensitive workflows

When to choose cloud vs. local

Start with cloud execution — it's the default for a reason. Scripts run faster, dependencies are handled for you, and nothing touches your local machine. The 5-minute session is enough for most tasks. Use the 30-minute session for long-running jobs like large dataset processing. Switch to local only when you need local file access or want to avoid credit usage entirely.

Cloud Session Options

Cloud scripts run in isolated sandboxes with two session lengths. Your agent picks the right one based on the task.

	5-Minute Session	30-Minute Session
Cost	Lower credits	Higher credits
Timeout	5 minutes of inactivity	30 minutes of inactivity
Best for	Quick tasks: file conversion, formatting, simple analysis	Heavy processing: large datasets, multi-step pipelines, ML tasks
Default?	Yes — recommended for most tasks	Only when needed

Real-World Examples

Just describe what you need done. Your agent finds the right skill, runs the script, and returns the results.

Process a file in the cloud

You: "Merge these three PDFs into one document."

Agent: finds PDF skill → runs merge script in cloud → merged PDF ready in seconds

Long-running analysis

You: "Analyze this 500MB CSV and generate a summary report with charts."

Agent: runs analysis script (30-min session) → processes data → returns report

Run locally for free

You: "Upload this skill file to my SkillzDrive."

Agent: downloads upload script → runs locally (free) → skill uploaded to your drive

Chain multiple scripts

You: "Extract text from this PDF, then translate it to Spanish."

Agent: runs extract script → runs translate script (same session) → translated text ready

API Keys & Credentials

Some skills need third-party API keys to work — for example, a skill that generates images might need a Gemini or OpenAI key. Your agent will tell you if a credential is missing and what's needed.

Where to add credentials

Add API keys in your SkillzDrive Account Settings under Credentials. They're encrypted and securely passed to scripts at runtime — never stored in the sandbox.

When Things Go Wrong

If a script fails, your agent will show you the error and suggest next steps. Common issues:

Issue	What happens	What to do
Missing credential	Script can't access a required API	Add the key in Account Settings → Credentials
Script timeout	Task took longer than session allows	Ask your agent to use a 30-minute session
Script error	Bug in the script itself	Your agent shows the error — try different input or a different skill
Insufficient credits	Not enough credits for cloud execution	Top up credits or run locally for free