universal-skills 1.0.1

A collection of universal skills for AI agents

Universal Skills - Pydantic AI Skills

Version: 1.0.1

Documentation — The complete catalog of universal skills, skill-graph authoring guidance, security and SSL configuration, and installation and integration instructions are maintained in the official documentation.

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]
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]
agent-tools/skill-workflow-builder	Brainstorm, structure, verify, and scaffold workflow-based skills.	SKILL_WORKFLOW_BUILDER_ENABLE=True (D)	universal-skills[skill-workflow-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 --insecure flag to disable SSL verification.
• Environment Variable: Set SSL_VERIFY=False (or 0, 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:

export PYDANTIC_AI_DOCS_ENABLE=True

Quick start — one-click install

Install the package and deploy every skill (incl. skill-installer and agent-os-genesis, alias agent-utilities-genesis) into all detected AI tools (Claude Code, Antigravity, Windsurf, OpenCode, Cursor, Zed, Codex, Devin) and the agent-utilities XDG space (~/.config/agent-utilities/skills), preferring symlinks to the installed package (Windows uses a directory junction, then a copy):

# one-click (clone, then run)
sh install.sh                       # PyPI install + symlink-deploy into all detected tools
sh install.sh --editable            # dev: editable install, skills symlink to your working tree
sh install.sh --skills agent-os-genesis   # only the genesis skill
sh install.sh --mcp ./mcp_config.json     # also wire MCP servers into detected tools
# Windows:  ./install.ps1  [-Editable] [-Skills agent-os-genesis] [-Mcp .\mcp_config.json]

Or the equivalent one-liner (no clone) — a persistent install is required so the symlinks resolve:

uv tool install universal-skills && install-skills --all-detected --symlink

Once installed, the skill-installer skill (and the install-skills CLI) are present, so any other skill can be deployed; agent-os-genesis is loadable in your tools — invoke it (or day0) to stand up the Agent OS, or "deploy <package> with agent-os-genesis" to provision a single connector.

Installation (manual / specific extras)

# 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]

# Then deploy skills into your tools (symlink preferred):
install-skills --all-detected --symlink

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
• Google
• Many more