Skip to content
Skills Library
AI & agents · Learning & explanation

tsk-help

/tsk-help

Use this skill when the user asks about tsk commands, delegating development tasks to AI agents, managing sandboxed task execution, or working with the tsk task queue and server.

Repository
tsk-tsk ↗
Licence
MIT
Last repository change
28.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 28.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use this skill when the user asks about tsk commands, delegating development tasks to AI agents, managing sandboxed task execution, or working with the tsk task queue and server.

Original author description

Use this skill when the user asks about tsk commands, delegating development tasks to AI agents, managing sandboxed task execution, or working with the tsk task queue and server.

How it works

  1. Core Commands
  2. How it works
  3. Multi-agent execution
  4. Custom templates
  5. Configuration
Original SKILL.md headings · 112 lines, 439 words
SKILL.md preview
---
name: tsk-help
description: Use this skill when the user asks about tsk commands, delegating development tasks to AI agents, managing sandboxed task execution, or working with the tsk task queue and server.
allowed-tools:
  - Bash(tsk help)
---

# tsk

`tsk` delegates development tasks to AI agents (Claude Code, Codex) running in isolated Docker/Podman containers. Agents work autonomously and produce git branches for review.

## Core Commands

### Run a task immediately

```bash
tsk run --type feat --name add-auth --prompt "Add JWT authentication to the API"
```

Key flags:
- `--type` (`-t`): Task template (feat, fix, doc, refactor, or custom templates)
- `--name` (`-n`): Human-readable name used in the git branch
- `--prompt` (`-p`): Task prompt (replaces `{{PROMPT}}` in templates)
- `--agent`: Agent to use (claude, codex). Default: claude
- `--edit`: Open the full prompt in your editor before sending

### Interactive sandbox

```bash
tsk shell
```

Drops you into a container with your repo copy and agent installed. Work interactively, then exit to save changes as a branch.

### Queue tasks for background execution

```bash
# Start the server with parallel workers
tsk server start --workers 4

# Queue tasks
tsk add -t feat -n user-api -p "Add REST API for user management"
tsk add -t fix -n login-bug -p "Fix session timeout on login page"

# Check status
tsk list
```

### Chain tasks

Child tasks start from where the parent left off:

```bash
tsk add -t feat -n add-api -p "Add users API endpoint"
tsk list  # get the task ID
tsk add -t feat -n add-tests -p "Add tests for users API" --parent <taskid>
```

### Other commands

This is the output of `tsk help`

!`tsk help`

## How it works

1. `tsk` copies your repository into an isolated directory (includes uncommitted changes by default, or use `--branch` to start from a specific branch's committed state)
2. A Docker/Podman container is started with your language stack and agent installed
3. Network access is restricted to approved API domains via a Squid proxy
4. The agent executes the task autonomously
5. Changes are fetched back as a new branch: `tsk/{type}/{name}/{id}`

## Multi-agent execution

Run the same task with multiple agents to compare results:

```bash
tsk add -t feat -n greeting --agent codex,claude -p "Add a greeting feature"
```

## Custom templates

Create templates in `~/.config/tsk/templates/` or `.tsk/templates/`:

```bash
mkdir -p ~/.config/tsk/templates
cat > ~/.config/tsk/templates/issue-bot.md << 'EOF'
Solve the GitHub issue below. Write tests and a descriptive commit message.

{{PROMPT}}
EOF

# Use it
gh issue view 42 | tsk add -t issue-bot -n fix-issue-42
```

## Configuration

`tsk` is configured via `~/.config/tsk/tsk.toml`. Key settings:

```toml
container_engine = "docker"  # or "podman"

[defaults]
memory_gb = 12.0
cpu = 8

[server]
auto_clean_enabled = true
auto_clean_age_days = 7.0

[project.my-project]
agent = "claude"
stack = "go"
```

See `tsk help` or `tsk help <command>` for full option details.

Versions

The database has no other skills named tsk-help.

Database snapshot: 13.11.2026 · package version ee2d3ae4f4b4 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100tsk-config
    Use this skill when the user wants to set up or configure tsk Docker container images, customize their tsk.toml for Docker builds, configure stack/agent/project layers, or troubleshoot tsk container build issues.
  • 100work-on
    Work on one task - a TSK id, an epic, a bug, or a described change - using the smallest effective agent team. Routes first, then implements directly, with one implementer, or with parallel specialist slices only when they are safely independent. Use when the user says "work on",…
  • 100cursor-delegate
    Delegate a coding task to the Cursor Agent CLI (`cursor-agent`) as a background implementer, then review its diff and land it yourself. Use this whenever the user wants to hand implementation work to Cursor — phrasings like "have Cursor implement X", "delegate this to Cursor",…
  • 100copilot-delegate
    Delegate a coding task to the GitHub Copilot CLI (`copilot`) as a background implementer, then review its diff and land it yourself. Use this whenever the user wants to delegate implementation work to Copilot - phrasings like "have Copilot implement X", "delegate this to…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.