Universal Skills - Pydantic AI Skills¶
Version: 0.8.0
Overview¶
Universal Skills is a collection of shared, reusable skills designed for Pydantic AI Agents. It provides a standardized way to give agents advanced capabilities like codebase searching, file navigation, and inter-agent communication.
Included Skills¶
The following universal skills are available. You can disable specific skills by setting their corresponding environment variables to False (default is True).
| Skill Directory | Description | Disable Flag | Install Command |
|---|---|---|---|
agent-tools/agent-browser |
Browser automation CLI for agents using the agent-browser tool. | AGENT_BROWSER_ENABLE=False |
universal-skills[agent-browser] |
agent-tools/agent-builder |
Templates and guidelines for building Single and Multi-Agent systems. | AGENT_BUILDER_ENABLE=False |
universal-skills[agent-builder] |
agent-tools/agent-spawner |
Spawns a Pydantic AI agent dynamically using an MCP configuration. | AGENT_SPAWNER_ENABLE=False |
universal-skills[agent-spawner] |
agent-tools/agent-workflows |
Agent-to-Agent communication, orchestration, and subagent dispatch. | AGENT_WORKFLOWS_ENABLE=False |
universal-skills[agent-workflows] |
creative/algorithmic-art |
Generative algorithmic art using p5.js and interactive artifacts. | ALGORITHMIC_ART_ENABLE=False |
universal-skills[algorithmic-art] |
api-wrapper-builder |
Guide for creating robust, standardized API wrappers. | API_WRAPPER_BUILDER_ENABLE=False |
universal-skills[api-wrapper-builder] |
research/brainstorming |
Structured ideation, problem-framing, and design research. | BRAINSTORMING_ENABLE=False |
universal-skills[brainstorming] |
creative/brand-guidelines |
Creating brand identity systems (logos, palettes, voice/tone). | BRAND_GUIDELINES_ENABLE=False |
universal-skills[brand-guidelines] |
web-dev/browser-tools |
Web browser interaction and E2E visual QA via Playwright. | BROWSER_TOOLS_ENABLE=False |
universal-skills[browser-tools] |
dev-workflows/c4-architecture |
Software architecture documentation using the C4 model in Mermaid. | C4_ARCHITECTURE_ENABLE=False |
universal-skills[c4-architecture] |
creative/canvas-design |
Programmatic graphic design using HTML Canvas or SVG APIs. | CANVAS_DESIGN_ENABLE=False |
universal-skills[canvas-design] |
infra/cloudflare-deploy |
Deploy applications and infrastructure to Cloudflare. | CLOUDFLARE_DEPLOY_ENABLE=True (D) |
universal-skills[cloudflare-deploy] |
workflows/infra/agent-os-genesis |
Agent OS Genesis — Day 0 Bootstrap & Multi-Service Wiring Orchestrator (alias: day0). |
AGENT_OS_GENESIS_ENABLE=True |
universal-skills[agent-os-genesis] |
core/code-enhancer |
12-domain code analysis with 0-100 grading, security/arch/dep audit. | CODE_ENHANCER_ENABLE=False |
universal-skills[code-enhancer] |
creative/creative-media |
Creative media processing (animations, GIFs, image conversion). | CREATIVE_MEDIA_ENABLE=False |
universal-skills[creative-media] |
integration/database-tools |
Connect and query PostgreSQL, MySQL, and MSSQL databases. | DATABASE_TOOLS_ENABLE=False |
universal-skills[database-tools] |
system/developer-utilities |
Formatting, conversion, generation, cryptographic, and networking. | DEVELOPER_UTILITIES_ENABLE=False |
universal-skills[developer-utilities] |
dev-workflows/diagnose |
Disciplined diagnosis loop for hard bugs and performance regressions. | DIAGNOSE_ENABLE=False |
universal-skills[diagnose] |
docs/document-converter |
Bulk convert .docx and .pdf to Markdown with high fidelity. | DOCUMENT_CONVERTER_ENABLE=False |
universal-skills[document-converter] |
docs/document-tools |
Read, edit, analyze, or create document files (PDF, spreadsheet, etc) | DOCUMENT_TOOLS_ENABLE=False |
universal-skills[document-tools] |
core/efficient-mode |
Ultra-compressed communication mode to reduce token usage. | EFFICIENT_MODE_ENABLE=False |
universal-skills[efficient-mode] |
integration/github-tools |
GitHub workflows, PR comments, CI fixes, and git practices. | GITHUB_TOOLS_ENABLE=False |
universal-skills[github-tools] |
integration/google-workspace |
Google Workspace ecosystem integration (Gmail, Drive, Docs, etc). | GOOGLE_WORKSPACE_ENABLE=True (D) |
universal-skills[google-workspace] |
product/internal-comms |
Creating internal announcements, memos, and executive briefings. | INTERNAL_COMMS_ENABLE=False |
universal-skills[internal-comms] |
integration/issue-triage |
Triage GitHub issues through a state machine of triage roles. | ISSUE_TRIAGE_ENABLE=False |
universal-skills[issue-triage] |
jira-tools |
Interact with Jira via CLI or Atlassian MCP for ticket management. | JIRA_TOOLS_ENABLE=False |
universal-skills[jira-tools] |
system/jupyter-notebook |
Create, scaffold, or edit Jupyter notebooks. | JUPYTER_NOTEBOOK_ENABLE=True (D) |
universal-skills[jupyter-notebook] |
docs/marp-presentations |
Create professional Marp Markdown presentation slides. | MARP_PRESENTATIONS_ENABLE=False |
universal-skills[marp-presentations] |
agent-tools/mcp-builder |
Guide for creating high-quality FastMCP servers. | MCP_BUILDER_ENABLE=False |
universal-skills[mcp-builder] |
docs/mermaid-diagrams |
Create software diagrams (class, sequence, flowchart, ERD, C4, etc). | MERMAID_DIAGRAMS_ENABLE=False |
universal-skills[mermaid-diagrams] |
product-management |
PRD development, user stories, prioritization, and roadmapping. | PRODUCT_MANAGEMENT_ENABLE=False |
universal-skills[product-management] |
product/product-strategy |
Market analysis, TAM/SAM/SOM, positioning, and SaaS metrics. | PRODUCT_STRATEGY_ENABLE=False |
universal-skills[product-strategy] |
project-planning |
High-level reasoning, brainstorming, debugging, and research. | PROJECT_PLANNING_ENABLE=False |
universal-skills[project-planning] |
qa-planning |
QA test plans, manual test cases, regression suites, and bug reports. | QA_PLANNING_ENABLE=False |
universal-skills[qa-planning] |
web-dev/react-development |
Type-safe React + TypeScript components, routing, and best practices. | REACT_DEVELOPMENT_ENABLE=False |
universal-skills[react-development] |
web-dev/react-native-skills |
React Native and Expo best practices and performance optimization. | REACT_NATIVE_SKILLS_ENABLE=False |
universal-skills[react-native-skills] |
infra/security-tools |
Threat modeling, Sentry error logs, and security code analysis. | SECURITY_TOOLS_ENABLE=False |
universal-skills[security-tools] |
core/skill-builder |
Tooling for creating and standardizing new universal skills. | SKILL_BUILDER_ENABLE=False |
universal-skills[skill-builder] |
agent-tools/skill-graph-builder |
Transform website documentation into indexed agent skills. | SKILL_GRAPH_BUILDER_ENABLE=True (D) |
universal-skills[skill-graph-builder] |
skill-installer |
Install skills into Windsurf, Claude Code, Antigravity, etc. | SKILL_INSTALLER_ENABLE=False |
universal-skills[skill-installer] |
core/session-handoff |
Create and restore agent session handoff documents. | SESSION_HANDOFF_ENABLE=False |
universal-skills[session-handoff] |
system/system-tools |
Hardware and OS operations (screenshots, bluetooth, tmux). | SYSTEM_TOOLS_ENABLE=False |
universal-skills[system-tools] |
systems-manager |
Fast codebase search, file navigation, and structural code analysis. | SYSTEMS_MANAGER_ENABLE=False |
universal-skills[systems-manager] |
dev-workflows/tdd-methodology |
Test-Driven Development workflow (Red-Green-Refactor cycle). | TDD_METHODOLOGY_ENABLE=False |
universal-skills[tdd-methodology] |
web-dev/theme-factory |
Designing themes, design tokens, and CSS variable systems. | THEME_FACTORY_ENABLE=False |
universal-skills[theme-factory] |
research/user-research |
User discovery, JTBD, personas, and journey mapping. | USER_RESEARCH_ENABLE=False |
universal-skills[user-research] |
web-dev/web-artifacts |
Frontend design, UI building, and artifact generation. | WEB_ARTIFACTS_ENABLE=False |
universal-skills[web-artifacts] |
web-dev/website-builder |
World-class frontend engineer for cinematic landing pages. | WEBSITE_BUILDER_ENABLE=False |
universal-skills[website-builder] |
web-dev/website-cloner |
Multi-phase pipeline for pixel-perfect website cloning. | WEBSITE_CLONER_ENABLE=False |
universal-skills[website-cloner] |
research/web-crawler |
High-speed recursive web crawling and sitemap processing. | WEB_CRAWLER_ENABLE=True (D) |
universal-skills[web-crawler] |
web-dev/web-design-guidelines |
Review UI code for Web Interface Guidelines compliance. | WEB_DESIGN_GUIDELINES_ENABLE=False |
universal-skills[web-design-guidelines] |
research/web-search |
Search the web via DDG, Google, Bing, or Searxng. | WEB_SEARCH_ENABLE=False |
universal-skills[web-search] |
system/zoom-out |
Meta-skill to tell the agent to step back and give broader context. | ZOOM_OUT_ENABLE=False |
universal-skills[zoom-out] |
Security & SSL Verification¶
All relevant scripts in Universal Skills support a standardized approach to SSL verification:
- CLI Override: Use the
--insecureflag to disable SSL verification. - Environment Variable: Set
SSL_VERIFY=False(or0,off) to disable verification globally. - Precedence: Command-line flags always take precedence over environment variables.
Building Your Own Skill-Graphs¶
Universal Skills includes a skill-graph-builder that allows you to transform any website's documentation into an indexed knowledge base for your agents. These are stored in your local cache directory (~/.cache/universal-skills/skill-graphs) and can be enabled via environment variables.
Example: Creating a Skill-Graph¶
You can prompt your agent to build a skill-graph for any technical documentation:
"Use the skill-graph-builder to crawl https://ai.pydantic.dev and create a skill-graph named 'pydantic-ai-docs'."
Once built, the graph will be available in your cache.
Enabling Your Graphs¶
To use a manually built graph, set its corresponding enable flag to True:
Installation¶
# Install with all standard skills
pip install universal-skills[all]
# Or install specific skill categories
pip install universal-skills[systems-manager,web-crawler,web-search]
Usage¶
Universal skills are typically loaded using the get_universal_skills_path() utility, which can be integrated into your agent's toolset. The utility will automatically respect the environment variables shown above to filter out disabled skills.
from universal_skills.skill_utilities import get_universal_skills_path, get_skill_graph_path
from pydantic_ai_skills import SkillsToolset
# Load enabled universal skills
skills_directories = [get_universal_skills_path(), get_skill_graph_path()]
skills = SkillsToolset(directories=skills_directories)
Attributions¶
- Claude
- Vercel
- Many more