Skip to content

README.md

Latest commit

 

History

History
68 lines (60 loc) · 7.77 KB

README.md

File metadata and controls

68 lines (60 loc) · 7.77 KB
Raw

Skillware Examples Index

These are usage examples, not tests. Runnable provider demos live here; automated tests live in skills/**/test_skill.py (bundle) and tests/ (framework and optional maintainer depth). See TESTING.md.

Runnable examples in this directory show how to load Skillware skills, adapt them for a provider, execute local skill logic, and return tool results to an agent loop. After pip install skillware, run skillware examples or skillware list --examples from any directory to browse the index in the terminal; when no local examples/README.md is present, the index is fetched from GitHub (network required); see CLI reference. Provider setup details live in the usage guides:

Use the package extra shown below when installing from PyPI: pip install "skillware[gemini]". For local development, use the same extra with editable install: pip install -e ".[gemini]".

Runnable Scripts

Script Skill ID Provider Required extra Required env vars Description
mental_coach_demo.py wellness/mental_coach Local execute base install only None Demonstrates coaching, crisis escalation, and blocked clinical paths locally.
build_dataset_demo.py data_engineering/synthetic_generator Local execute (Gemini backend) [gemini] GOOGLE_API_KEY Generates a JSONL synthetic dataset with the synthetic generator skill.
claude_pdf_form_filler.py office/pdf_form_filler Claude [claude], [office] ANTHROPIC_API_KEY Uses Claude with the PDF form filler skill to map instructions to fields.
claude_tos_evaluator.py compliance/tos_evaluator Claude [claude] ANTHROPIC_API_KEY Runs a Claude tool loop for website automation policy review.
claude_issue_resolver.py dev_tools/issue_resolver Claude [claude] ANTHROPIC_API_KEY; optional GITHUB_TOKEN Claude loop for GitHub issue analysis; fetches issue data after prepare (sample: issue #123).
claude_wallet_check.py finance/wallet_screening Claude [claude] ANTHROPIC_API_KEY, ETHERSCAN_API_KEY Screens an Ethereum wallet and returns the result through a Claude tool loop.
deepseek_tos_evaluator.py compliance/tos_evaluator DeepSeek [openai] DEEPSEEK_API_KEY Uses the OpenAI-compatible DeepSeek API for terms-of-service evaluation.
gemini_pdf_form_filler.py office/pdf_form_filler Gemini [gemini], [office] GOOGLE_API_KEY, ANTHROPIC_API_KEY Uses Gemini as the agent while the PDF skill calls Anthropic for form filling.
gemini_tos_evaluator.py compliance/tos_evaluator Gemini [gemini] GOOGLE_API_KEY Runs the terms-of-service evaluator with a Gemini function-calling loop.
gemini_wallet_check.py finance/wallet_screening Gemini [gemini] GOOGLE_API_KEY, ETHERSCAN_API_KEY Screens an Ethereum wallet with Gemini orchestration and Etherscan data.
gemini_evm_tx_handler.py defi/evm_tx_handler Gemini [gemini] GOOGLE_API_KEY; for live swaps also AGENT_WALLET_PRIVATE_KEY, BASE_RPC_URL or ETHEREUM_RPC_URL. Set EVM_TX_HANDLER_EXAMPLE_DEMO=1 for mocked flow without keys. Resolve → quote → preview → execute buy flow via Gemini tool loop (or demo mode).
claude_evm_tx_handler.py defi/evm_tx_handler Claude [claude] ANTHROPIC_API_KEY; for live swaps also AGENT_WALLET_PRIVATE_KEY, RPC URLs. Demo: EVM_TX_HANDLER_EXAMPLE_DEMO=1. Claude tool loop for structured DeFi intent and optional execute after confirmation.
mica_claude_flow.py compliance/mica_module Claude [claude] ANTHROPIC_API_KEY Runs a MiCA compliance agent loop through Claude.
mica_ollama_flow.py compliance/mica_module Ollama No Skillware extra; install ollama separately None Runs a local Ollama MiCA flow with prompt-mode tool calling.
mica_rag_flow.py compliance/mica_module Gemini [gemini] GOOGLE_API_KEY Runs the MiCA RAG flow with Gemini.
ollama_skills_test.py finance/wallet_screening, office/pdf_form_filler, optimization/prompt_rewriter Ollama [office]; install ollama separately ETHERSCAN_API_KEY, ANTHROPIC_API_KEY Loads multiple skills and tests prompt-mode tool calling with Ollama.
ollama_tos_evaluator.py compliance/tos_evaluator Ollama No Skillware extra; install ollama separately None Runs the terms-of-service evaluator with local Ollama prompt-mode calls.
openai_tos_evaluator.py compliance/tos_evaluator OpenAI [openai] OPENAI_API_KEY Runs the terms-of-service evaluator with OpenAI function calling.
pii_guardrail_flow.py compliance/pii_masker Local execute base install only None Demonstrates local PII masking before passing text to an external agent.
prompt_compression_demo.py optimization/prompt_rewriter Local execute base install only None Demonstrates prompt compression without a provider loop.
novelty_extractor_demo.py data_engineering/novelty_extractor Local execute pip install fastembed numpy None Demonstrates multi-turn corpus distillation using local embeddings with no API key.
gemini_novelty_extractor.py data_engineering/novelty_extractor Gemini [gemini], pip install fastembed numpy GOOGLE_API_KEY Runs the novelty extractor with a Gemini function-calling loop.
ollama_novelty_extractor.py data_engineering/novelty_extractor Ollama pip install fastembed numpy; install ollama separately None Runs the novelty extractor with local Ollama prompt-mode calls.
gemini_issue_resolver.py dev_tools/issue_resolver Gemini [gemini] GOOGLE_API_KEY; optional GITHUB_TOKEN Gemini loop for GitHub issue analysis; fetches issue data after prepare (sample: issue #123).
ollama_issue_resolver.py dev_tools/issue_resolver Ollama No Skillware extra; install ollama separately optional GITHUB_TOKEN; OLLAMA_MODEL (default gemma4:e2b) Ollama prompt-mode loop for GitHub issue analysis (sample: issue #123).
token_limiter_loop.py monitoring/token_limiter Local execute base install only None Simulates a runaway task hitting a token ceiling with deterministic budget checks.
gemini_token_limiter.py monitoring/token_limiter Gemini [gemini] Optional GOOGLE_API_KEY for Phase 2 live loop Local budget simulation plus optional Gemini tool loop.
claude_token_limiter.py monitoring/token_limiter Claude [claude] Optional ANTHROPIC_API_KEY for Phase 2 live loop Local budget simulation plus optional Claude tool loop.
gemini_uk_companies_house_handler.py finance/uk_companies_house_handler Gemini [gemini] GOOGLE_API_KEY, COMPANIES_HOUSE_API_KEY Resolve company, officers, filings via Gemini tool loop.
uk_companies_house_handler_demo.py finance/uk_companies_house_handler Local execute base install only None Runs a scripted sequence (resolve, profile, officers, pscs, filings) with mocked HTTP responses (no API keys needed).

Notes

  • Agent-side model keys such as GOOGLE_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, and DEEPSEEK_API_KEY are documented in the provider guides.
  • Skill runtime keys such as ETHERSCAN_API_KEY are documented in each skill manifest and on the skill catalog pages.
  • Ollama examples require the Python ollama package, a local Ollama server, and the model named in the script, but no cloud API key.