Tsk Add

What it does

When your agent uses it

• Development work in your project

Example prompts

• “/tsk-add”

Requirements

• Pre-approved tools (allowed-tools): Bash(tsk help), Bash(tsk add --help), Bash(tsk template list), Bash(tsk template show)

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1Summarize the agreed-upon work: Review the conversation above and identify
2. 2Create a task name: Come up with a short, branch-friendly name (e.g., add-auth, refactor-api, fix-validation)
3. 3Pick the best template: Based on the nature of the task, choose the template from the list above that best matches the work to be done…
4. 4Write the task prompt: Create a clear, self-contained prompt that includes
5. 5Queue the task: Use tsk add to create the task

What it can do on your machine

Read from SKILL.md and the folder at commit bc0c0c6. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(tsk help)
  • Bash(tsk add --help)
  • Bash(tsk template list)
  • Bash(tsk template show)

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tsk Add loads about 1k tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 422 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~19

When it runs · the whole SKILL.md, loaded when a task matches

~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from dtormoen/tsk-tsk at commit bc0c0c6, republished under its MIT licence (© dtormoen). 422 words, ~1,037 tokens.

name

tsk-add

description

Queue a single task based on the current conversation using tsk add

allowed-tools

Bash(tsk help), Bash(tsk add --help), Bash(tsk template list), Bash(tsk template show)

argument-hint

optional additional context

user-invocable

true

disable-model-invocation

true

!`tsk template list`

tsk add -t <template> -n "<task-name>" <<'EOF'
<task description>
EOF

# Alternatively:

tsk add -t <template> --prompt-file <path_to_the_plan>

tsk add -t feat -n "add-rate-limiting" <<'EOF'
Add rate limiting to the API endpoints.

### Context
The API currently has no rate limiting, which could allow abuse. We discussed using a token bucket algorithm with Redis for distributed rate limiting.

### Requirements
- Add rate limiting middleware to all /api/* routes
- Use token bucket algorithm: 100 requests per minute per API key
- Store rate limit state in Redis (connection config already exists)
- Return 429 Too Many Requests with Retry-After header when limit exceeded

### Files to Focus On
- src/middleware/ - add new rate limiting middleware
- src/routes/api.ts - apply middleware to routes
- src/config/redis.ts - reuse existing Redis connection

### Acceptance Criteria
- Rate limiting works correctly under load
- Proper error responses with Retry-After header
- Tests cover rate limit enforcement and reset behavior
EOF

!`tsk help`

!`tsk add --help`

© dtormoen, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/tsk-add/skills/tsk-add of dtormoen/tsk-tsk.

Open the folder on GitHubat commit bc0c0c6