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.
When & Why to Use This Skill
The Task Runner skill integrates the 'just' command runner into Claude's workflow, enabling the AI to automatically discover, list, and execute project-specific commands. It streamlines development by providing a standardized interface for common operations like building, testing, and linting, ensuring cross-platform consistency and significantly boosting developer productivity through natural language task execution.
Use Cases
- Project Onboarding: Quickly understand a new codebase by listing all available recipes and descriptions using 'just --list' without manual documentation review.
- Automated Testing and QA: Trigger comprehensive test suites (e.g., 'just test') directly through Claude to validate code changes instantly.
- Build and Environment Management: Execute complex build pipelines or environment-specific deployment scripts (e.g., 'just deploy production') with minimal friction.
- Code Quality Enforcement: Maintain high standards by running linting and formatting tasks (e.g., 'just lint') as part of the development conversation.
| name | task-runner |
|---|---|
| description | "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." |
| compatibility | "Requires just CLI tool. Install: brew install just (macOS) or cargo install just (cross-platform)." |
| allowed-tools | "Bash Glob" |
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
# 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
# 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
# Check if justfile exists
just --summary
# Show recipe details
just --show test
# List recipes with descriptions
just --list
When to Use
- First check:
justto 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:
just --list
This shows what commands are available without reading documentation.