# Task

> A Claude skill from aksika/abtars.

- **Type:** Skill
- **Install:** `agentstack add skill-aksika-abtars-task`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [aksika](https://agentstack.voostack.com/s/aksika)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [aksika](https://github.com/aksika)
- **Source:** https://github.com/aksika/abtars/tree/dev/templates/skills/task
- **Website:** https://aksika.github.io/

## Install

```sh
agentstack add skill-aksika-abtars-task
```

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

## About

# Task Management

Create, edit, and manage scheduled tasks. Tasks live at `~/.abtars/tasks/` — each task is a directory.

## Structure

```
~/.abtars/tasks/
├── tasks.json              # Registry: schedule, kind, taskFile path (definitions only)
├── task-state.json          # Runtime state (auto-managed, do not edit)
├── task-history.jsonl       # Append-only run log (auto-managed)
├── my-task/
│   ├── TASK.md              # Main prompt (what the agent does)
│   ├── feeds.json           # Associated data (auto-injected)
│   └── report-template.md   # Any supporting files
```

All files in a task directory (except TASK.md) are automatically injected as context when the task runs.

## Creating a task

1. Create the directory and TASK.md:
```bash
mkdir -p ~/.abtars/tasks/my-task
cat > ~/.abtars/tasks/my-task/TASK.md 
```

## Schedule format

Standard cron: `minute hour day month weekday`

| Example | Meaning |
|---------|---------|
| `0 9 * * *` | Daily at 9am |
| `30 8 * * 1-5` | Weekdays at 8:30am |
| `0 0 * * *` | Midnight daily |
| `0 */6 * * *` | Every 6 hours |

For one-shot tasks, use `--at "2026-12-25T08:00"` instead of `--schedule`.

## Task kinds

| Kind | Behavior |
|------|----------|
| `agent` | Agent session runs the prompt or TASK.md |
| `script` | Shell command runs directly |
| `reminder` | Simple text reminder at scheduled time |
| `orc` | Orc project dispatch |
| `system` | Internal bridge action (sleep-cycle, hardware-sleep) |

## Delivery modes

Set `delivery` in tasks.json. Each kind has a required delivery mode.

| Mode | Behavior | Use for |
|------|----------|---------|
| `report` | Drop the result file to chat (no model call) | Reports, generated documents |
| `announce` | Send the agent's response text directly | Greetings, conversational tasks |
| `silent` | No output to user | Internal housekeeping, scripts |

Example:

```json
{
  "id": "finance-report",
  "kind": "agent",
  "agent": "task",
  "delivery": "report",
  "schedule": "30 9 * * *",
  "prompt": "Run the finance report",
  "chatId": "7773842843",
  "enabled": true
}
```

## Managing tasks

```bash
abtars-task list                # Show all tasks
abtars-task remove          # Delete a task
abtars-task pause           # Pause a task
abtars-task resume          # Resume a paused task
abtars-task history         # Show run history
abtars-task validate [path]     # Dry-run check of tasks.json (default: live file)
```

`abtars-task validate` checks a whole `tasks.json` before it goes live: invalid
entries, duplicate IDs, missing `taskFile` and `report.requires.files` paths,
and orphaned task package directories. It prints one JSON result, exits `0`
when clean and `1` otherwise, and never changes files or task state. Run it
after any manual edit of `~/.abtars/tasks/tasks.json`.

Or via Telegram: `/tasks` (list), `/task run ` (trigger), `/task pause `, `/task resume `.

## Tips

- Keep TASK.md focused — one clear instruction per task
- Put data files (feeds, watchlists, templates) as siblings — they auto-inject
- Use `schedule` for recurring tasks and `at` for one-shots
- The DoD section in TASK.md must contain absolute paths only (one per bullet)

## Source & license

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

- **Author:** [aksika](https://github.com/aksika)
- **Source:** [aksika/abtars](https://github.com/aksika/abtars)
- **License:** Apache-2.0
- **Homepage:** https://aksika.github.io/

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-aksika-abtars-task
- Seller: https://agentstack.voostack.com/s/aksika
- 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%.