Agent skill
sagebase-commands
Provides quick reference for all Sagebase CLI commands and Docker operations. Activates when user asks how to run application, test, format code, manage database, or execute any Sagebase operation. Includes just commands, unified CLI, testing, formatting, and database management.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/testing/sagebase-commands-trust-chain-organiza-sagebase-4a26bdec
SKILL.md
Sagebase Commands
Purpose
Quick reference for all Sagebase CLI commands and Docker operations.
When to Activate
This skill activates automatically when:
- User asks how to run the application
- User mentions "run", "execute", "test", "format", or "database"
- User asks about Docker commands
- User needs to perform any Sagebase operation
Quick Command Reference
Just Commands (Recommended)
just up # Start containers and launch Streamlit
just down # Stop and remove containers
just db # Connect to database
just test # Run tests with type checking
just format # Format code with ruff
just lint # Lint and auto-fix code
just monitoring # Launch monitoring dashboard
just process-minutes # Process meeting minutes
just logs # View container logs
just ports # Show current port configuration
See reference.md for all just commands.
Main Application Commands
# Process minutes
just exec uv run sagebase process-minutes
# Scrape politicians
just exec uv run sagebase scrape-politicians --all-parties
# Launch Streamlit UI
just exec uv run sagebase streamlit
# Launch monitoring
just exec uv run sagebase monitoring
# Show coverage stats
just exec uv run sagebase coverage
Testing Commands
# Run all tests
just test
# Run specific test file
just exec uv run pytest tests/unit/domain/test_speaker_domain_service.py
# Run with coverage
just exec uv run pytest --cov=src --cov-report=html
Code Quality Commands
# Format code
just format
# Lint code
just lint
# Type check (local only)
uv run --frozen pyright
Database Commands
# Connect to PostgreSQL
just db
# Backup database
just exec uv run sagebase database backup
# Restore database
just exec uv run sagebase database restore backup.sql
# Reset database
./reset-database.sh
Command Categories
- Environment Setup: Docker, dependencies, GCS
- Application Execution: Process minutes, scrape, UI
- Testing: pytest, coverage, evaluation
- Code Quality: ruff, pyright, pre-commit
- Database: backup, restore, migrations
- Conference Members: Extract, match, create affiliations
- Parliamentary Groups: Extract, match, memberships
Detailed Reference
For complete command documentation with all options and examples, see reference.md.
Workflow Examples
For common workflows combining multiple commands, see examples.md.
Templates and Scripts
templates/: Command templates for common operationsscripts/: Helper scripts for complex workflows
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?