# Config Schedule

> Use when user asks to schedule workflows, manage cron jobs for automated workflow execution, enable/disable schedule triggers, or view workflow execution schedules.

- **Type:** Skill
- **Install:** `agentstack add skill-vibesurf-ai-claude-surf-config-schedule`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [vibesurf-ai](https://agentstack.voostack.com/s/vibesurf-ai)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [vibesurf-ai](https://github.com/vibesurf-ai)
- **Source:** https://github.com/vibesurf-ai/claude-surf/tree/main/skills/config-schedule

## Install

```sh
agentstack add skill-vibesurf-ai-claude-surf-config-schedule
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Config Schedule - Workflow Schedule Management

## Overview

Manage scheduled workflow executions using cron expressions. Schedule workflows to run automatically at specified times.

## When to Use

- User wants to schedule a workflow to run automatically
- User needs to set up cron-based workflow triggers
- User wants to enable/disable existing schedules
- User needs to view or update workflow schedules
- User wants to see which workflows have schedules configured

## API Endpoints

Base path: `$VIBESURF_ENDPOINT/api/schedule`

### Schedule Management

| Action | Method | Endpoint | Description |
|--------|--------|----------|-------------|
| List Schedules | GET | `/api/schedule` | Get all workflow schedules |
| Get Schedule | GET | `/api/schedule/{flow_id}` | Get schedule for specific workflow |
| Create Schedule | POST | `/api/schedule` | Create new schedule for a workflow |
| Update Schedule | PUT | `/api/schedule/{flow_id}` | Update existing schedule |

## Request Examples

### Create Schedule
```json
POST /api/schedule
{
  "flow_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "cron_expression": "0 9 * * 1-5",
  "is_enabled": true,
  "description": "Run every weekday at 9 AM"
}
```

### Update Schedule
```json
PUT /api/schedule/{flow_id}
{
  "cron_expression": "0 12 * * *",
  "is_enabled": true,
  "description": "Run daily at noon"
}
```

### Enable/Disable Schedule
```json
PUT /api/schedule/{flow_id}
{
  "is_enabled": false
}
```

## Schedule Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| flow_id | string | Yes | Workflow/Flow ID to schedule |
| cron_expression | string | No | Cron expression (e.g., '0 9 * * 1-5') |
| is_enabled | bool | No | Whether the schedule is active |
| description | string | No | Description of the schedule |

## Cron Expression Format

Standard cron format: `minute hour day_of_month month day_of_week`

| Expression | Description |
|------------|-------------|
| `0 9 * * 1-5` | Every weekday at 9:00 AM |
| `0 12 * * *` | Every day at 12:00 PM |
| `0 */6 * * *` | Every 6 hours |
| `0 0 * * 0` | Every Sunday at midnight |
| `0 8,20 * * *` | At 8:00 AM and 8:00 PM daily |

## Workflow

1. **Get workflow ID** → From existing workflows or import
2. **Create schedule** → `POST /api/schedule` with cron expression
3. **Verify schedule** → `GET /api/schedule/{flow_id}` to confirm
4. **Update as needed** → `PUT /api/schedule/{flow_id}` to modify

## Notes

- Each workflow can only have one schedule
- Schedules are automatically reloaded after creation/update
- The schedule manager must be running for schedules to execute
- `next_execution_at` is automatically calculated from the cron expression

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [vibesurf-ai](https://github.com/vibesurf-ai)
- **Source:** [vibesurf-ai/claude-surf](https://github.com/vibesurf-ai/claude-surf)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-vibesurf-ai-claude-surf-config-schedule
- Seller: https://agentstack.voostack.com/s/vibesurf-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.