- Updated: March 21, 2026
- 5 min read
Introducing Skillware: A Modular AI Skill Management Framework
Skip to content You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert ARPAHLS / skillware Public Notifications You must be signed in to change notification settings Fork 7 Star 18 Code Issues 16 Pull requests 0 Actions Projects Security 0 Insights Additional navigation options Code Issues Pull requests Actions Projects Security Insights mainBranchesTagsGo to fileCodeOpen more actions menuFolders and filesNameNameLast commit messageLast commit dateLatest commit History46 Commits46 Commits.github.github assetsassets docsdocs examplesexamples skillsskills skillwareskillware templates/python_skilltemplates/python_skill teststests .env.example.env.example .flake8.flake8 .gitignore.gitignore COMPARISON.mdCOMPARISON.md CONTRIBUTING.mdCONTRIBUTING.md LICENSELICENSE README.mdREADME.md SECURITY.mdSECURITY.md pyproject.tomlpyproject.toml requirements.txtrequirements.txt View all filesRepository files navigationREADMEContributingMIT licenseSecurity A Python framework for modular, self-contained skill management for machines. Mission • Architecture • Quick Start • Documentation • Contributing • Comparison • Contact Skillware is an open-source framework and registry for modular, actionable Agent capabilities. It treats Skills as installable content, decoupling capability from intelligence.Just as apt-get installs software and pip installs libraries, skillware installs know-how for AI agents. “I know Kung Fu.” – Neo Mission The AI ecosystem is fragmented. Developers often re-invent tool definitions, system prompts, and safety rules for every project. Skillware supplies a standard to package capabilities into self-contained units that work across Gemini, Claude, GPT, and Llama.A Skill in this framework provides everything an Agent needs to master a domain: Logic: Executable Python code. Cognition: System instructions and “cognitive maps”. Governance: Constitution and safety boundaries. Interface: Standardized schemas for LLM tool calling. Architecture This repository is organized into a core framework, a registry of skills, and documentation. Skillware/ ├── skillware/ # Core Framework Package │ └── core/ │ ├── base_skill.py # Abstract Base Class for skills │ ├── loader.py # Universal Skill Loader & Model Adapter │ └── env.py # Environment Management ├── skills/ # Skill Registry (Domain-driven) │ ├── category/ # e.g., finance, optimization, data_engineering │ │ └── skill_name/ # e.g., prompt_rewriter, wallet_screening ├── templates/ # New Skill Templates │ └── python_skill/ # Standard Python Skill Template ├── examples/ # Reference Implementations │ ├── gemini_wallet_check.py # Google Gemini Integration │ ├── claude_wallet_check.py # Anthropic Claude Integration │ ├── gemini_pdf_form_filler.py │ └── claude_pdf_form_filler.py ├── docs/ # Comprehensive Documentation │ ├── introduction.md # Philosophy & Design │ ├── usage/ # Integration Guides │ └── skills/ # Skill Reference Cards └── COMPARISON.md # Comparison vs. Anthropic Skills / MCP Quick Start 1.Installation You can install Skillware directly from PyPI: pip install skillware Or for development, clone the repository and install in editable mode: git clone https://github.com/arpahls/skillware.git cd skillware pip install -e . Note: Individual skills may have their own dependencies. The SkillLoader validates manifest.yaml and warns of missing packages (e.g., requests, pandas) upon loading a skill. 2. Configuration Create a .env file with your API keys (e.g., Google Gemini API Key): GOOGLE_API_KEY=”your_key” 3. Usage Example (Gemini) import google.generativeai as genai from skillware.core.loader import SkillLoader from skillware.core.env import load_env_file # Load Environment load_env_file() # 1. Load the Skill from the Registry # The loader reads the code, manifest, and instructions automatically skill_bundle = SkillLoader.load_skill(“category/skill_name”) # 2. Model & Chat Setup model = genai.GenerativeModel( ‘gemini-2.5-flash’, tools=[SkillLoader.to_gemini_tool(skill_bundle)], # The “Adapter” system_instruction=skill_bundle[‘instructions’] # The “Mind” ) chat = model.start_chat(enable_automatic_function_calling=True) # 3. Agent Loop # The SDK handles the loop: model -> tool call -> execution -> result -> model reply. response = chat.send_message(“Screen wallet 0xd8dA. for risks.”) print(response.text) Documentation Core Logic & Philosophy: Details on how Skillware decouples Logic, Cognition, and Governance.Usage Guide: Gemini: Integration with Google’s GenAI SDK. Usage Guide: Claude: Integration with Anthropic’s SDK. Skill Library: Available capabilities. Contributing We are building the “App Store” for Agents and require professional, robust, and safe skills. Please read CONTRIBUTING.md for guidelines on folder structure, manifest schemas, and safety constitutions.Comparison Skillware differs from the Model Context Protocol (MCP) or Anthropic’s Skills repository in the following ways: Model Agnostic: Native adapters for Gemini, Claude, and OpenAI. Code-First: Skills are executable Python packages, not just server specs. Runtime-Focused: Provides tools for the application, not just recipes for an IDE. Read the full comparison here. Contact For questions, suggestions, or contributions, please open an issue or reach out to us: Email: skillware-os@arpacorp.net Issues: GitHub Issues Built & Maintained by ARPA Hellenic Logical Systems & the Community About A Python framework for modular, self-contained skill management for machines. arpa.systems Topics ai-agents llm-tools function-calling agentic-framework agentic-ai agentic-workflows agent-skills skillware Resources Readme License MIT license Contributing Contributing Security policy Security policy Uh oh! There was an error while loading. Please reload this page.Activity Custom properties Stars 18 stars Watchers 3 watching Forks 7 forks Report repository Releases 3 v0.2.1 Latest Mar 21, 2026 + 2 releases Packages 0 Uh oh! There was an error while loading. Please reload this page. Contributors 1 rosspeili ツンデレ Languages Python 100.0% You can’t perform that action at this time. [{“Name”:”.github”,”Last commit message”:””,”Last commit date”:””},{“Name”:”assets”,”Last commit message”:””,”Last commit date”:””},{“Name”:”docs”,”Last commit message”:””,”Last commit date”:””},{“Name”:”examples”,”Last commit message”:””,”Last commit date”:””},{“Name”:”skills”,”Last commit message”:””,”Last commit date”:””},{“Name”:”skillware”,”Last commit message”:””,”Last commit date”:””},{“Name”:”templates/python_skill”,”Last commit message”:””,”Last commit date”:””},{“Name”:”tests”,”Last commit message”:””,”Last commit date”:””},{“Name”:”.env.example”,”Last commit message”:””,”Last commit date”:””},{“Name”:”.flake8″,”Last commit message”:””,”Last commit date”:””},{“Name”:”.gitignore”,”Last commit message”:””,”Last commit date”:””},{“Name”:”COMPARISON.md”,”Last commit message”:””,”Last commit date”:””},{“Name”:”CONTRIBUTING.md”,”Last commit message”:””,”Last commit date”:””},{“Name”:”LICENSE”,”Last commit message”:””,”Last commit date”:””},{“Name”:”README.md”,”Last commit message”:””,”Last commit date”:””},{“Name”:”SECURITY.md”,”Last commit message”:””,”Last commit date”:””},{“Name”:”pyproject.toml”,”Last commit message”:””,”Last commit date”:””},{“Name”:”requirements.txt”,”Last commit message”:””,”Last commit date”:””},{}]