archibate/dotfiles-opencode / skills/uv
uv
FlaggedUse this skill when using UV (Python package manager), needs to set up Python virtual environments, install/manage Python CLI tools, migrate from pip/pipx to UV, Python version management, or troubleshoot UV-related issues.
examples/README.md
View on GitHub# UV Real-World Examples
## Overview
This directory contains real-world examples, common patterns, and anti-patterns for UV usage across different scenarios.
## Example Categories
### [Inline Script Metadata](inline-scripts.md)
PEP 723 inline script metadata examples with UV. Learn how to create self-contained Python scripts with embedded dependencies.
**Topics:**
- Basic inline dependencies
- Python version requirements
- MCP server with inline dependencies
- Data processing scripts
- When to use inline metadata
### [MCP Server Examples](mcp-servers.md)
Complete MCP server configuration examples for various platforms and use cases.
**Topics:**
- Published MCP servers (official, AWS, etc.)
- VS Code and Continue IDE configurations
- Local development setup
- Multi-configuration development
### [Development Workflows](development-workflows.md)
Complete development tool setup and daily workflow patterns.
**Topics:**
- Python development environment setup
- Project-specific script execution
- Multi-version testing workflows
### [Virtual Environment Workflows](virtual-environments.md)
Virtual environment management patterns and best practices.
**Topics:**
- Basic project setup
- Existing project migration
- Multi-environment projects
### [CI/CD Examples](ci-cd.md)
Continuous integration and deployment configurations.
**Topics:**
- GitHub Actions workflows
- GitLab CI pipelines
### [Migration Examples](migrations.md)
Migration guides from other Python tools to UV.
**Topics:**
- From pip to UV
- From pipx to UV tool
- From poetry to UV
### [Common Patterns](common-patterns.md)
Frequently used patterns and configurations.
**Topics:**
- Development tool suite setup
- Pre-commit integration
- Shell configuration
### [Anti-Patterns](anti-patterns.md)
Common mistakes to avoid when using UV.
**Topics:**
- Global pip installs
- Installing MCP servers with uv tool
- Using uvx for daily tools
- Mixed tool management
- Forgetting virtual environments
### [Complete Workflow](complete-workflow.md)
End-to-end example of setting up a new Python project with UV.
**Topics:**
- Full project initialization
- Git setup
- Dependency management
- Testing and formatting
- Documentation
## How to Use These Examples
1. **Browse by topic** - Use the category links above to find relevant examples
2. **Copy and adapt** - All examples are designed to be copied and modified for your needs
3. **Follow patterns** - Use the "DO" examples and avoid the "DON'T" anti-patterns
4. **Refer to related docs** - Each example file links to relevant reference documentation
## Related Documentation
- [Installation and Setup](../references/installation-and-setup.md)
- [Tool Management](../references/tool-management.md)
- [Python Environment Management](../references/python-environment.md)
- [Inline Script Metadata](../references/inline-script-metadata.md)
- [MCP Integration](../references/mcp-integration.md)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |