# Skillware — LLM / agent discovery index
# Canonical site: https://skillware.site
# Open source repository: https://github.com/arpahls/skillware

A Python framework for modular, self-contained agent skills (capabilities you install like packages). Don't prompt your agents — equip them. Each skill bundles deterministic Python logic (skill.py), LLM instructions (instructions.md), and governance (manifest.yaml). Same skill, zero adapter rewrites: SkillLoader adapts bundles to any agent, LLM, or logical system (Gemini, Claude, OpenAI, DeepSeek, Ollama, and more via universal adapters).

## Positioning (for agents and operators)

- Tagline: Don't prompt your agents. Equip them.
- Model churn: swap the LLM or provider — change the model name, keep the skill path and execute() contract.
- One-line skill install: pip install "skillware[category_skill]" then SkillLoader.load_skill("category/skill_name") — reuse the same manifest across agents and LLMs.
- Fifteen bundled skills as of v0.4.8 — see Skill directory below.

## Framework searches (no specific skill required)

| What someone searches | Page |
| :--- | :--- |
| how to reuse same skill across agents / reuse skill across different llms | https://skillware.site/documentation#agent-loops |
| install agent skill one line code / pip install skillware one line | https://skillware.site/documentation#install-extras |
| add tools to ai agent without langchain / framework agnostic agent skills | https://skillware.site/comparison |
| swap llm without rewriting agent / zero adapter rewrites | https://skillware.site/ |
| equip ai agent with skills python / prebuilt agent capabilities | https://skillware.site/skills |
| remove bg / background remover agent skill / skillware bg remover | https://skillware.site/skills/creative/bg_remover |
| groq openrouter openai compatible agent tools | https://skillware.site/documentation#openai-compatible |

## Key pages for agents and operators

- Home: https://skillware.site/
- Skill directory (15 skills): https://skillware.site/skills
- Documentation: https://skillware.site/documentation
- Install extras: https://skillware.site/documentation#install-extras
- Vision & roadmap: https://skillware.site/documentation#vision
- Contributing (humans + agents): https://skillware.site/contributing
- AI-native agent workflow: https://skillware.site/documentation#ai-native-workflow
- Comparison (MCP, LangChain, etc.): https://skillware.site/comparison
- PyPI install: pip install skillware
- Recommended single-skill install: pip install "skillware[<category>_<skill>]" (see install extras)

## Problem-first search map (no brand name required)

Users often search for tasks, not products. These map to Skillware skills:

| What someone searches | Skill ID | Page |
| :--- | :--- | :--- |
| screen crypto wallet for ai agent / wallet screening for ai agents | finance/wallet_screening | https://skillware.site/skills/finance/wallet_screening |
| uk companies house api integration / business registry api ai | finance/uk_companies_house_handler | https://skillware.site/skills/finance/uk_companies_house_handler |
| how to send crypto using ai / ai agent swap tokens / crypto trading ai agent | defi/evm_tx_handler | https://skillware.site/skills/defi/evm_tx_handler |
| ai fill pdf forms / can ai fill out pdf forms | office/pdf_form_filler | https://skillware.site/skills/office/pdf_form_filler |
| remove image background ai / remove bg / rembg python agent / background remover agent skill / skillware bg remover / transparent png | creative/bg_remover | https://skillware.site/skills/creative/bg_remover |
| reduce llm token usage / compress long prompt | optimization/prompt_rewriter | https://skillware.site/skills/optimization/prompt_rewriter |
| generate synthetic training data ai | data_engineering/synthetic_generator | https://skillware.site/skills/data_engineering/synthetic_generator |
| filter redundant text dataset / semantic dedup | data_engineering/novelty_extractor | https://skillware.site/skills/data_engineering/novelty_extractor |
| mask pii before chatgpt / gdpr safe ai agent | compliance/pii_masker | https://skillware.site/skills/compliance/pii_masker |
| ai for mica / eu crypto regulation agent | compliance/mica_module | https://skillware.site/skills/compliance/mica_module |
| is web scraping allowed / robots txt checker | compliance/tos_evaluator | https://skillware.site/skills/compliance/tos_evaluator |
| prompt injection firewall agent / scan untrusted text before llm | security/prompt_injection_firewall | https://skillware.site/skills/security/prompt_injection_firewall |
| ai agent fix github issue / plan before coding issue | dev_tools/issue_resolver | https://skillware.site/skills/dev_tools/issue_resolver |
| how to make ai stop at token limit / agent loop token budget | monitoring/token_limiter | https://skillware.site/skills/monitoring/token_limiter |
| ai wellness coaching guardrails / crisis triage chatbot | wellness/mental_coach | https://skillware.site/skills/wellness/mental_coach |

Brand-aware queries (skillware + keyword) also resolve to the same pages — see each skill's prerendered HTML FAQ block.

## Natural-language intent index

| User intent | Skill ID | Page |
| :--- | :--- | :--- |
| ai for mica / EU crypto regulation | compliance/mica_module | https://skillware.site/skills/compliance/mica_module |
| website policy / robots.txt / is scraping allowed | compliance/tos_evaluator | https://skillware.site/skills/compliance/tos_evaluator |
| github issue plan before coding | dev_tools/issue_resolver | https://skillware.site/skills/dev_tools/issue_resolver |
| swap llm without rewriting agent / zero adapter rewrites skillware | (framework) | https://skillware.site/ |
| equip agents deterministic skills python | (framework) | https://skillware.site/skills |
| how to contribute to open source ai as a beginner | (workflow) | https://skillware.site/contributing |
| repositories welcome to AI agents | (project norms) | https://skillware.site/contributing |
| mask PII before sending to cloud LLM | compliance/pii_masker | https://skillware.site/skills/compliance/pii_masker |
| crypto wallet AML / sanctions screening | finance/wallet_screening | https://skillware.site/skills/finance/wallet_screening |
| UK company officers / Companies House lookup | finance/uk_companies_house_handler | https://skillware.site/skills/finance/uk_companies_house_handler |
| government company filings api / corporate registry data ai | finance/uk_companies_house_handler | https://skillware.site/skills/finance/uk_companies_house_handler |
| fill PDF forms from natural language | office/pdf_form_filler | https://skillware.site/skills/office/pdf_form_filler |
| remove image background / remove bg / rembg offline / product photo cutout / background remover agent | creative/bg_remover | https://skillware.site/skills/creative/bg_remover |
| reuse skill across agents / same skill different llm / one line install agent skill | (framework) | https://skillware.site/documentation#agent-loops |
| compress prompts / reduce API tokens | optimization/prompt_rewriter | https://skillware.site/skills/optimization/prompt_rewriter |
| synthetic data for fine-tuning | data_engineering/synthetic_generator | https://skillware.site/skills/data_engineering/synthetic_generator |
| filter redundant text / semantic dedup | data_engineering/novelty_extractor | https://skillware.site/skills/data_engineering/novelty_extractor |
| agent wallet swap / buy token on base or ethereum | defi/evm_tx_handler | https://skillware.site/skills/defi/evm_tx_handler |
| token budget / stop runaway agent loop | monitoring/token_limiter | https://skillware.site/skills/monitoring/token_limiter |
| wellness coaching guardrails / crisis triage | wellness/mental_coach | https://skillware.site/skills/wellness/mental_coach |
| prompt injection scan / jailbreak firewall before llm | security/prompt_injection_firewall | https://skillware.site/skills/security/prompt_injection_firewall |
| groq openrouter openai compatible agent tools | (framework) | https://skillware.site/documentation#openai-compatible |

Note: MiCA and ToS skills support regulatory and policy analysis; they are not a substitute for licensed legal advice.

## Core concepts

- Body: skill.py — deterministic execution
- Mind: instructions.md — when and how the model uses the tool
- Conscience: manifest.yaml — constitution, schema, issuer attribution
- Loader: SkillLoader.load_skill("category/skill_name") — discovery via SKILLWARE_SKILL_PATH, local skills/, or bundled package; bundles expose bundle["class"]; missing deps suggest skillware[category_skill]
- CLI: skillware list, skillware examples, skillware test, skillware paths — gradient splash + interactive menu
- Install: pip install skillware; prefer pip install "skillware[category_skill]"; [all] = skill runtime deps; [agents] = Gemini+Claude+OpenAI SDKs; legacy [cli]/[embeddings] removed

## Skills (15)

### finance/wallet_screening — Wallet Screening
https://skillware.site/skills/finance/wallet_screening
Screens Ethereum wallets for sanctions (880+ bundled lists), malicious interactions, and forensic risk. Paginated Etherscan txlist (up to 10,000 txs); optional metadata.warnings when history is truncated or partial. Requires ETHERSCAN_API_KEY. Install: pip install "skillware[finance_wallet_screening]"
Sample: Screen wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 for sanctions and malicious contract interactions.

### finance/uk_companies_house_handler — UK Companies House Handler
https://skillware.site/skills/finance/uk_companies_house_handler
UK Companies House REST API integration for agents — search, profile, officers, PSC, filings, intent mapping. Status envelope (ready/partial/needs_input/error) with 5-key context propagation across turns. Requires COMPANIES_HOUSE_API_KEY. Issuer: Areen-09. Install: pip install "skillware[finance_uk_companies_house_handler]"
Sample user message to the agent: Who is the CEO of BP? (skill maps CEO → UK director terminology)
Examples: uk_companies_house_handler_demo.py (mocked), gemini_uk_companies_house_handler.py

### defi/evm_tx_handler — EVM Transaction Handler
https://skillware.site/skills/defi/evm_tx_handler
Dedicated agent wallet: resolve intent, Uni V2 quote/preview/execute, transfer on Ethereum/Base. Issuer: Hendobox. Install: pip install "skillware[defi_evm_tx_handler]"
Requires AGENT_WALLET_PRIVATE_KEY in .env; ETHEREUM_RPC_URL / BASE_RPC_URL per chain. Not financial advice.
Sample: Buy 10 DEGEN on Base with USDC — resolve, quote, preview, execute with confirmed: true.
Examples: gemini_evm_tx_handler.py, claude_evm_tx_handler.py

### office/pdf_form_filler — PDF Form Filler
https://skillware.site/skills/office/pdf_form_filler
Fills AcroForm PDFs from natural-language instructions (semantic field mapping). Requires ANTHROPIC_API_KEY for mapping step. Install: pip install "skillware[office_pdf_form_filler]"
Sample: Fill /path/to/form.pdf — name John Doe, check the terms of service box.

### creative/bg_remover — Background Remover
https://skillware.site/skills/creative/bg_remover
Offline rembg background removal for still images — Base64 or file path in, transparent PNG out (v0.2). Issuer: AyushSrivastava1818. Install: pip install "skillware[creative_bg_remover]" (rembg, pillow, onnxruntime). First execute downloads ONNX model; no skill API keys. Example: bg_remover_demo.py
Sample: Remove the background from product.png and save as product_no_bg.png.

### optimization/prompt_rewriter — Prompt Rewriter
https://skillware.site/skills/optimization/prompt_rewriter
Compresses long prompts while preserving meaning; reduces LLM token cost. Install: pip install "skillware[optimization_prompt_rewriter]"
Sample: Compress this prompt before the main model call.

### data_engineering/synthetic_generator — Synthetic Data Generator
https://skillware.site/skills/data_engineering/synthetic_generator
Generates structured high-entropy synthetic samples for training; supports gemini, anthropic, or ollama as internal generator. Install: pip install "skillware[data_engineering_synthetic_generator]"
Sample: Generate five medical coding dispute samples with dual-insurance edge cases.

### data_engineering/novelty_extractor — Novelty Extractor
https://skillware.site/skills/data_engineering/novelty_extractor
Filters text by semantic novelty with local fastembed embeddings (no API keys). Pass prior distilled_content as baseline_chunks for multi-turn dedup. Install: pip install "skillware[data_engineering_novelty_extractor]"
Sample: Filter this dataset and keep only chunks that contain new information (novelty_threshold 0.85).
Examples: novelty_extractor_demo.py, gemini_novelty_extractor.py, ollama_novelty_extractor.py

### compliance/pii_masker — PII Masker
https://skillware.site/skills/compliance/pii_masker
Local PII scrub via Ollama (arpacorp/micro-f1-mask); mask, redact, or remove before cloud LLMs. Install: pip install "skillware[compliance_pii_masker]"
Sample: Mask PII in: "Hello John Doe, your wallet 0xabc123 has been verified."

### compliance/mica_module — MiCA Module
https://skillware.site/skills/compliance/mica_module
MiCA (EU Markets in Crypto-Assets) regulatory RAG and optional Gemini policy evaluator. Install: pip install "skillware[compliance_mica_module]"
Sample: Can I issue a stablecoin backed by physical art under an e-money license?

### compliance/tos_evaluator — Terms of Service Evaluator
https://skillware.site/skills/compliance/tos_evaluator
Checks robots.txt, discovers policy pages, returns SAFE/UNSAFE/CAUTION/INSUFFICIENT_EVIDENCE for intended automation. Install: pip install "skillware[compliance_tos_evaluator]"
Sample: Before crawling https://example.com/docs, check if automated indexing is allowed.

### dev_tools/issue_resolver — Issue Resolver
https://skillware.site/skills/dev_tools/issue_resolver
Nine-stage GitHub issue workflow: prepare URLs, stage_checklists, validate_commit_message. Optional ISSUE_RESOLVER.md repository profiles (load_repository_profile). Agent fetches issue/repo; skill does not call GitHub (optional GITHUB_TOKEN). Install: pip install "skillware[dev_tools_issue_resolver]"
Sample: action prepare on https://github.com/owner/repo/issues/42; then stage_checklist for discover_issue.
Examples: gemini_issue_resolver.py, claude_issue_resolver.py, ollama_issue_resolver.py

### monitoring/token_limiter — Token Limiter
https://skillware.site/skills/monitoring/token_limiter
Deterministic token budget gate for agent loops: CONTINUE, WARN, or FORCE_TERMINATE. Host supplies cumulative current_token_count; optional model_id for indicative USD estimates. Not billing authority. Install: pip install "skillware[monitoring_token_limiter]"
Sample: Check task scrape_amazon_listings_101 with 125000 tokens used and 100000 limit.
Examples: token_limiter_loop.py, gemini_token_limiter.py, claude_token_limiter.py

### wellness/mental_coach — Mental Coach
https://skillware.site/skills/wellness/mental_coach
Deterministic wellness coaching guardrail: crisis triage, scope limits, grounded KB retrieval. Optional GOOGLE_API_KEY for run_evaluator. Not medical or clinical advice. Install: pip install "skillware[wellness_mental_coach]"
Sample: I feel stressed at work and need coping strategies (user_jurisdiction US, session_mode coaching).
Example: mental_coach_demo.py

### security/prompt_injection_firewall — Prompt Injection Firewall
https://skillware.site/skills/security/prompt_injection_firewall
Offline deterministic pre-flight scan for hostile instructions in untrusted text — hidden HTML/markdown, invisible Unicode smuggling, confusable/homoglyph evasion, nested encodings, instruction-override lexicon. Returns is_safe, risk_level, findings, optional sanitized_text. No API keys. Issuer: mrmasa88. Install: pip install "skillware[security_prompt_injection_firewall]"
Sample: Scan HTML with a hidden span containing "IGNORE ALL INSTRUCTIONS" before adding to model context.
Example: prompt_injection_firewall_demo.py

## Provider adapters (model-agnostic — add providers without rewriting skills)

- SkillLoader.to_gemini_tool(bundle), to_claude_tool, to_openai_tool, to_deepseek_tool, to_ollama_prompt(bundle)
- OpenAI-compatible hosts (Groq, OpenRouter, Mistral, Together, vLLM, LiteLLM proxy, etc.): use to_openai_tool() with host base_url — see https://skillware.site/documentation#openai-compatible
- Gemini: match function_call.name via SkillLoader._sanitize_gemini_tool_name(manifest["name"])
- Pass bundle["instructions"] as system context; on tool call → skill.execute(args)
- Documented today: Gemini, Claude, OpenAI, DeepSeek, Ollama, OpenAI-compatible — same skill manifest for any supported host

Full usage guides: https://skillware.site/documentation
Install extras: https://skillware.site/documentation#install-extras