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.
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.
Teams using task-runner should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
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.