Agent skill
tech-stack-adapter
Detects Python project configuration and provides commands for testing, building, coverage, and containerization. Use when: Starting workflow, detecting project stack, need TEST_CMD Triggers: detect stack, what commands, initial setup Outputs: TEST_CMD, BUILD_CMD, COVERAGE_CMD, COVERAGE_CHECK, MIGRATE_CMD
Install this agent skill to your Project
npx add-skill https://github.com/stharrold/yuimedi-paper-20250901/tree/main/.claude/skills/tech-stack-adapter
SKILL.md
Tech Stack Adapter
Purpose
One-time detection of Python/uv project configuration. Returns standardized commands for use throughout workflow.
Detection Script
Run scripts/detect_stack.py to analyze the project and generate command configuration.
Usage in Workflow
# Run once at workflow start
python .claude/skills/tech-stack-adapter/scripts/detect_stack.py > /tmp/stack_config.json
# Access in other skills
export TEST_CMD=$(jq -r '.test_cmd' /tmp/stack_config.json)
export BUILD_CMD=$(jq -r '.build_cmd' /tmp/stack_config.json)
export COVERAGE_CHECK=$(jq -r '.coverage_check' /tmp/stack_config.json)
Output Format
{
"stack": "python",
"package_manager": "uv",
"project_name": "project-name",
"repo_root": "/path/to/repo",
"install_cmd": "uv sync",
"test_cmd": "uv run pytest",
"build_cmd": "uv build",
"coverage_cmd": "uv run pytest --cov=src --cov-report=term",
"coverage_check": "uv run pytest --cov=src --cov-report=term --cov-fail-under=80",
"database": "sqlite",
"orm": "sqlalchemy",
"migrate_cmd": "uv run alembic upgrade head",
"container": "podman",
"has_containerfile": false,
"has_compose": false,
"test_framework": "pytest",
"has_pytest_cov": true
}
Detected Configuration
The script detects:
- Package manager: uv or pip
- Test framework: pytest, unittest, or none
- Coverage tool: pytest-cov presence
- Database: SQLite, PostgreSQL (via SQLAlchemy), or none
- ORM: SQLAlchemy, none
- Migrations: Alembic presence
- Container: Containerfile and podman-compose.yml existence
Integration with Other Skills
All other skills should call this detector first to get project-specific commands:
import json
import subprocess
# Run detector
result = subprocess.run(
['python', '.claude/skills/tech-stack-adapter/scripts/detect_stack.py'],
capture_output=True,
text=True
)
config = json.loads(result.stdout)
# Use detected commands
subprocess.run(config['test_cmd'].split())
subprocess.run(config['coverage_check'].split())
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
workflow-utilities
Shared utilities for file deprecation, directory structure creation, TODO file updates, workflow lifecycle management, archive management, and VCS abstraction (GitHub/Azure DevOps). Used by all other skills. Use when: Need shared utilities, deprecating files, updating TODO, registering/archiving workflows, managing TODO.md manifest, VCS operations, PR feedback handling Triggers: deprecate, archive, update TODO, create directory, register workflow, archive workflow, sync manifest, VCS operations, PR feedback
initialize-repository
Meta-skill (Phase 0) for bootstrapping new repositories with workflow system. Interactive callable tool that copies skills, documentation, and standards from source repository. Use when: Starting a new project that needs the workflow system Triggers: "initialize new repository", "bootstrap workflow", "replicate workflow system"
agentdb-state-manager
Persistent state management using AgentDB (DuckDB) for workflow analytics and checkpoints. Provides read-only analytics cache synchronized from TODO_*.md files, enabling: - Complex dependency graph queries - Historical workflow metrics - Context checkpoint storage/recovery - State transition analysis Use when: Data gathering and analysis for workflow state tracking Triggers: "analyze workflow", "query state", "checkpoint", "workflow metrics"
workflow-orchestrator
Orchestrates git workflow for Python feature/release/hotfix development. Loads and coordinates other skills based on current context. Includes PR feedback handling via work-item generation. Use when: - User says "next step?" or "continue workflow" - Working in git repo with TODO_[feature|release|hotfix]_*.md files - Need to determine workflow phase and load appropriate skills - Handling PR feedback via work-items Triggers: next step, continue, what's next, workflow status, PR feedback Coordinates: tech-stack-adapter, git-workflow-manager, bmad-planner, speckit-author, quality-enforcer, workflow-utilities Context management: Prompt user to run /context when context usage is high, then /init to reset before continuing workflow.
git-workflow-manager
Manages git operations: worktree creation, branch management, commits, PRs, semantic versioning, daily rebase workflow, and PR feedback handling. Use when: Creating branches/worktrees, committing, pushing, versioning, handling PR feedback Triggers: create worktree, commit, push, rebase, version, PR, PR feedback
workflow-utilities
Shared utilities for file deprecation, directory structure creation, TODO file updates, workflow lifecycle management, archive management, and VCS abstraction (GitHub/Azure DevOps). Used by all other skills. Use when: Need shared utilities, deprecating files, updating TODO, registering/archiving workflows, managing TODO.md manifest, VCS operations, PR feedback handling Triggers: deprecate, archive, update TODO, create directory, register workflow, archive workflow, sync manifest, VCS operations, PR feedback
Didn't find tool you were looking for?