task-runner
Run project commands with just. Check for justfile in project root, list available tasks, execute common operations like test, build, lint. Triggers on: run tests, build project, list tasks, check available commands, run script, project commands.
Best use case
task-runner is best used when you need a repeatable AI agent workflow instead of a one-off prompt. It is especially useful for teams working in multi. Run project commands with just. Check for justfile in project root, list available tasks, execute common operations like test, build, lint. Triggers on: run tests, build project, list tasks, check available commands, run script, project commands.
Run project commands with just. Check for justfile in project root, list available tasks, execute common operations like test, build, lint. Triggers on: run tests, build project, list tasks, check available commands, run script, project commands.
Users should expect a more consistent workflow output, faster repeated execution, and less time spent rewriting prompts from scratch.
Practical example
Example input
Use the "task-runner" skill to help with this workflow task. Context: Run project commands with just. Check for justfile in project root, list available tasks, execute common operations like test, build, lint. Triggers on: run tests, build project, list tasks, check available commands, run script, project commands.
Example output
A structured workflow result with clearer steps, more consistent formatting, and an output that is easier to reuse in the next run.
When to use this skill
- Use this skill when you want a reusable workflow rather than writing the same prompt again and again.
When not to use this skill
- Do not use this when you only need a one-off answer and do not need a reusable workflow.
- Do not use it if you cannot install or maintain the related files, repository context, or supporting tools.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/task-runner/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How task-runner Compares
| Feature / Agent | task-runner | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Run project commands with just. Check for justfile in project root, list available tasks, execute common operations like test, build, lint. Triggers on: run tests, build project, list tasks, check available commands, run script, project commands.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Task Runner
## Purpose
Execute project-specific commands using just, a modern command runner that's simpler than make and works cross-platform.
## Tools
| Tool | Command | Use For |
|------|---------|---------|
| just | `just` | List available recipes |
| just | `just test` | Run specific recipe |
## Usage Examples
### Basic Usage
```bash
# List all available recipes
just
# Run a recipe
just test
just build
just lint
# Run recipe with arguments
just deploy production
# Run specific recipe from subdirectory
just --justfile backend/justfile test
```
### Common justfile Recipes
```just
# Example justfile
# Run tests
test:
pytest tests/
# Build project
build:
npm run build
# Lint code
lint:
ruff check .
eslint src/
# Start development server
dev:
npm run dev
# Clean build artifacts
clean:
rm -rf dist/ build/ *.egg-info/
# Deploy to environment
deploy env:
./scripts/deploy.sh {{env}}
```
### Discovery
```bash
# Check if justfile exists
just --summary
# Show recipe details
just --show test
# List recipes with descriptions
just --list
```
## When to Use
- First check: `just` to see available project commands
- Running tests: `just test`
- Building: `just build`
- Any project-specific task
- Cross-platform command running
## Best Practice
Always check for a justfile when entering a new project:
```bash
just --list
```
This shows what commands are available without reading documentation.Related Skills
task-planning
Plan and organize software development tasks effectively. Use when breaking down features, creating user stories, or planning sprints. Handles task breakdown, user stories, acceptance criteria, and backlog management.
task-estimation
Estimate software development tasks accurately using various techniques. Use when planning sprints, roadmaps, or project timelines. Handles story points, t-shirt sizing, planning poker, and estimation best practices.
task-execution-engine
Execute implementation tasks from design documents using markdown checkboxes. Use when (1) implementing features from feature-design-assistant output, (2) resuming interrupted work, (3) batch executing tasks. Triggers on 'start implementation', 'run tasks', 'resume'.
lark-task
飞书任务：管理任务和清单。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务时使用。
tasks-generator
Generate structured task roadmaps from project specifications. Use when the user asks to create tasks, sprint plans, roadmaps, or work breakdowns based on PRD (Product Requirements Document), Tech Specs, or UI/UX specs. Triggers include requests like "generate tasks from PRD", "create sprint plan", "break down this spec into tasks", "create a roadmap", or "plan the implementation".
cross-task-learning
Pattern for aggregating insights across multiple tasks to enable data-driven evolution.
managing-task-lifecycle
Use when starting, pausing, completing, or transitioning task status in the development workflow.
iterative-runner
Runs Claude in a retry loop until tests pass or task completes. Use for TDD loops, overnight builds, or any task needing repeated iteration until success. Triggers on: loop until done, keep trying, retry until pass, TDD loop, iterate until tests pass.
tasknotes
Manage tasks in Obsidian via TaskNotes plugin API. Use when user wants to create tasks, list tasks, query by status or project, update task status, delete tasks, or check what they need to do.
parallel-task
Only to be triggered by explicit /parallel-task commands.
parallel-task-spark
Only to be triggered by explicit /parallel-task-spark commands.
browser-task-and-automation-and-delegation
【强制】所有浏览器操作必须使用本技能，禁止在主对话中直接使用 mcp__chrome-devtools 工具。触发关键词：打开/访问/浏览网页、点击/填写/提交表单、截图/快照、性能分析、自动化测试、数据采集/爬取、网络模拟。本技能通过 chrome-devtools-expert agent 执行浏览器操作，避免大量页面快照、截图、网络请求数据污染主对话上下文。