ai-skill-governance 0.3.0

Govern AI skill growth through intelligent merging of similar capabilities — no blocking, only consolidation. Built for LangChain, CrewAI, and custom agent systems.

AI Skill Governance

Govern AI skill growth through intelligent merging — not blocking.

Prevent skill bloat in AI agents by automatically detecting and merging similar capabilities while preserving functionality.

Support

If this project is useful to you, consider supporting development:

Why AI Skill Governance?

Modern AI agents can accumulate dozens or hundreds of skills. This leads to:

• Context dilution
• Slower reasoning
• Conflicting behaviors
• Maintenance nightmare

AI Skill Governance solves this by intelligently merging similar skills instead of arbitrarily limiting them.

Before / After

A support agent accumulates 12 skills over a few iterations. Many overlap.

Cluster	Before	After
Greetings	greet, welcome, say_hi, hello_user	greet
Refunds	refund, return_payment, issue_refund	refund
Lookups	find_order, search_orders, get_order_by_id	find_order
One-offs	escalate, close_ticket	escalate, close_ticket
Total	12 skills · ~840 tool-list tokens*	5 skills · ~350 tokens

→ 58% fewer skills. ~58% smaller tool-list prompt. Same coverage, faster tool selection, fewer conflicting behaviors.

_{*Illustrative. Tool-list tokens depend on serialization format (OpenAI function-calling schema, Anthropic tool blocks, etc.). The skill-count reduction is deterministic; token savings scale roughly with it.}

Installation

pip install ai-skill-governance

For faster fuzzy matching:

pip install "ai-skill-governance[fuzzy]"

Quick Start

from ai_skill_governance import SkillRegistry

registry = SkillRegistry(default_threshold=0.75)

@registry.register(description="Sends a warm greeting")
def greet(name: str):
    return f"Hello, {name}!"

@registry.register(description="Welcomes the user warmly")
def welcome(name: str):
    return f"Welcome, {name}!"

# Check for suggested merges
print(registry.suggest_merges())

# Perform merge (v0.1.1: includes signature compatibility check)
merged = registry.perform_merge("greet", "welcome")
print(merged)

# Persistence (new in v0.1.1)
registry.save("my_skills.json")
registry.load("my_skills.json")

Advanced Merging

The merger creates a smart combined function that:

• Preserves the primary behavior
• Augments with secondary skill when signatures match
• Intelligently combines string/dict results
• Maintains full traceability

CLI

# Show status
skill-gov status --threshold 0.8

# Analyze and suggest merges
skill-gov merge --threshold 0.75

# Auto-merge similar skills
skill-gov merge --auto

Configuration

• default_threshold: Similarity cutoff (0.0–1.0). Default: 0.75
• merge_mode: "suggest" (default) or "auto"

v0.3.0 New Features

Skill Graph Visualization

from ai_skill_governance import SkillRegistry, SkillGraph

reg = SkillRegistry()
# ... register skills ...

graph = SkillGraph(reg)
print(graph.to_ascii())           # Simple text view
dot = graph.to_dot("skills.dot")  # Graphviz format
data = graph.to_json("graph.json") # For web dashboards

Semantic Merging (Major Upgrade)

pip install "ai-skill-governance[semantic]"

from ai_skill_governance import SkillRegistry

reg = SkillRegistry()
suggestions = reg.suggest_merges(method="semantic")  # Uses embeddings when available

LangChain Integration

from ai_skill_governance.integrations.langchain import LangChainSkillGovernor

governor = LangChainSkillGovernor()
# Use @governor.register_tool on your LangChain @tool functions

CrewAI Integration

from ai_skill_governance.integrations.crewai import CrewAISkillGovernor

PyPI Release Notes

This package is fully prepared for PyPI publication with:

• Modern pyproject.toml
• Proper metadata and classifiers
• Optional dependencies (fuzzy for rapidfuzz)
• Comprehensive documentation
• MIT License

Contributing

We welcome contributions that improve merging intelligence, add new similarity methods, or enhance the governance dashboard.

License

MIT License — see LICENSE file.