Deploy & Test

Once you have written a skill, you need to deploy it, install it into a workspace, and verify it works. This page covers all three steps.

Deploy

aerostack auth login

aerostack project use my-project

aerostack deploy skill

Deploying skill: send-email
  Bundling src/index.ts...
  Uploading to project my-project...
  Skill deployed successfully.

  Skill ID:   sk_abc123def456
  Name:        send-email
  Tool:        send_email
  Status:      active

Install into a Workspace

A deployed skill is not usable until it is installed into a workspace. Once installed, every consumer of that workspace can call it.

# Set the active workspace
aerostack workspace use my-workspace
 
# Install the skill
aerostack skill install send-email

aerostack skill list

Workspace: my-workspace

  Skill              Tool                          Status
  send-email         send-email__send_email        active
  generate-pdf       generate-pdf__generate_pdf    active

Test Locally

Before deploying, you can test your skill locally using the Aerostack CLI’s development server.

aerostack dev

curl -X POST http://localhost:8787 \
  -H "Content-Type: application/json" \
  -d '{
    "to": "[email protected]",
    "subject": "Test Email",
    "body": "<h1>Hello</h1><p>This is a test.</p>"
  }'

{
  "success": true,
  "email_id": "abc123",
  "to": "[email protected]",
  "subject": "Test Email"
}

RESEND_API_KEY=re_test_xxxxxxxxxxxxx
[email protected]

Testing with environment bindings

If your skill uses Database, Cache, or Storage bindings, the CLI creates local instances automatically. To set up a local database schema:

# Apply your schema to the local database instance
aerostack db execute --local --file=schema.sql

Then aerostack dev will use the local database with your schema applied.

Verify in Workspace

After deploying and installing, verify the skill works end-to-end by calling it through the workspace.

Using an LLM client

Connect any MCP-compatible LLM client (Claude Desktop, Cursor, etc.) to your workspace URL. Ask the LLM to use your skill:

“Send an email to [email protected] with the subject ‘Weekly Report’ and the body ‘Here is your weekly summary.’”

The LLM will discover the send_email tool in the workspace and call it.

Using the workspace API directly

You can also call skills through the workspace REST API:

curl -X POST https://your-project.aerostack.dev/api/v1/workspace/my-workspace/tools/send-email__send_email \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "[email protected]",
    "subject": "Weekly Report",
    "body": "Here is your weekly summary."
  }'

Checking logs

View skill execution logs in the Admin Dashboard under Skills > select your skill > Logs. Logs show:

• Request timestamp
• Input parameters (redacted for secrets)
• Response status code
• Execution duration
• Any errors

Updating a Deployed Skill

To update a skill that is already deployed:

# Make your changes to src/index.ts or aerostack.json
# Then redeploy
aerostack deploy skill

The update is applied immediately. All workspaces that have the skill installed will use the new version. There is no need to reinstall.

Removing a Skill

Remove from a workspace

aerostack skill remove

This launches an interactive prompt to select which skill to remove from the active workspace.

Delete the deployment

To delete the skill entirely (removes it from all workspaces):

1. Go to Skills in the Admin Dashboard
2. Select the skill
3. Click Delete

Troubleshooting

Next Steps

• Publish to Hub — share your skill with the Aerostack community
• CLI skill commands — full reference for all skill-related CLI commands