openclaw-plus — Skillopedia

OpenClaw+ 🚀 A modular super-skill that combines essential developer tools and web capabilities into a unified, powerful workflow. Overview OpenClaw+ integrates seven core capabilities into one streamlined skill: Developer Skills: - - Execute Python code with proper environment management - - Check repository status and track changes - - Commit changes with meaningful messages - - Install Python packages with dependency handling Web Skills: - - Retrieve web content with robust error handling - - Make API requests with authentication and response parsing This modular design allows you to chain…

)),\n 'rating': float(item.find('span', class_='rating').text),\n 'url': item.find('a')['href']\n }\n products.append(product)\n\n# Store in SQLite\nconn = sqlite3.connect('products.db')\ncursor = conn.cursor()\n\ncursor.execute('''\n CREATE TABLE IF NOT EXISTS products (\n id INTEGER PRIMARY KEY,\n name TEXT,\n price REAL,\n rating REAL,\n url TEXT\n )\n''')\n\nfor p in products:\n cursor.execute('''\n INSERT INTO products (name, price, rating, url)\n VALUES (?, ?, ?, ?)\n ''', (p['name'], p['price'], p['rating'], p['url']))\n\nconn.commit()\nconn.close()\n\nprint(f'Scraped and stored {len(products)} products')\n\"\"\")\n\n# Step 4: Commit\ngit_commit(\"chore: update product database\")\n```\n\n### Example 3: API Testing Suite\n```python\n# User request: \"Test our API endpoints and generate report\"\n\n# Step 1: Install testing framework\ninstall_package(\"pytest requests pytest-html\")\n\n# Step 2: Create test file and run\nrun_python(\"\"\"\nimport requests\nimport json\nfrom datetime import datetime\n\nBASE_URL = \"https://api.example.com\"\nresults = []\n\n# Test 1: Health check\ntry:\n response = requests.get(f\"{BASE_URL}/health\")\n results.append({\n 'test': 'Health Check',\n 'status': response.status_code,\n 'passed': response.status_code == 200,\n 'response_time': response.elapsed.total_seconds()\n })\nexcept Exception as e:\n results.append({\n 'test': 'Health Check',\n 'status': 'Error',\n 'passed': False,\n 'error': str(e)\n })\n\n# Test 2: Authentication\ntry:\n headers = {'Authorization': 'Bearer test-token'}\n response = requests.get(f\"{BASE_URL}/auth/validate\", headers=headers)\n results.append({\n 'test': 'Authentication',\n 'status': response.status_code,\n 'passed': response.status_code == 200,\n 'response_time': response.elapsed.total_seconds()\n })\nexcept Exception as e:\n results.append({\n 'test': 'Authentication',\n 'status': 'Error',\n 'passed': False,\n 'error': str(e)\n })\n\n# Test 3: Data retrieval\ntry:\n response = requests.get(f\"{BASE_URL}/data/users\")\n data = response.json()\n results.append({\n 'test': 'Data Retrieval',\n 'status': response.status_code,\n 'passed': response.status_code == 200 and len(data) > 0,\n 'records': len(data) if response.status_code == 200 else 0,\n 'response_time': response.elapsed.total_seconds()\n })\nexcept Exception as e:\n results.append({\n 'test': 'Data Retrieval',\n 'status': 'Error',\n 'passed': False,\n 'error': str(e)\n })\n\n# Generate report\nreport = {\n 'timestamp': datetime.now().isoformat(),\n 'total_tests': len(results),\n 'passed': sum(1 for r in results if r.get('passed')),\n 'failed': sum(1 for r in results if not r.get('passed')),\n 'results': results\n}\n\nwith open('api_test_report.json', 'w') as f:\n json.dump(report, f, indent=2)\n\nprint(f\"Tests complete: {report['passed']}/{report['total_tests']} passed\")\nfor r in results:\n status = '✓' if r.get('passed') else '✗'\n print(f\"{status} {r['test']}\")\n\"\"\")\n\n# Step 3: Check and commit\ngit_status()\ngit_commit(\"test: add API endpoint tests\")\n```\n\n---\n\n## Integration with Other Skills\n\nOpenClaw+ works seamlessly with other skills:\n\n### With `docx` skill:\n```python\n# Generate data, then create report\ncall_api(\"https://api.example.com/stats\")\nrun_python(\"process_stats.py\")\n# Then use docx skill to create formatted report\n```\n\n### With `xlsx` skill:\n```python\n# Fetch data, process with Python, export to Excel\nfetch_url(\"https://data-source.com/raw.csv\")\nrun_python(\"clean_and_transform.py\")\n# Then use xlsx skill to create formatted spreadsheet\n```\n\n### With `pptx` skill:\n```python\n# Generate charts and data visualizations\ninstall_package(\"matplotlib seaborn\")\nrun_python(\"generate_charts.py\")\n# Then use pptx skill to create presentation\n```\n\n---\n\n## Quick Reference\n\n### Python Execution\n```python\nrun_python(code_string)\n```\n\n### Package Management\n```bash\ninstall_package(\"package_name\")\ninstall_package(\"package==1.0.0\")\ninstall_package(\"-r requirements.txt\")\n```\n\n### Git Operations\n```bash\ngit_status()\ngit_commit(\"message\")\ngit_commit(\"message\", stage_all=True)\n```\n\n### Web Requests\n```python\nfetch_url(url, timeout=30)\ncall_api(url, method=\"GET\", auth_token=\"token\")\n```\n\n---\n\n## Conclusion\n\nOpenClaw+ provides a unified, powerful toolkit for development and web automation workflows. By combining Python execution, package management, git operations, and web capabilities, it enables complex multi-step workflows with a single cohesive skill.\n\n**Key strengths:**\n- ✅ Modular design - use only what you need\n- ✅ Error handling - robust failure recovery\n- ✅ Workflow composition - chain operations easily\n- ✅ Production-ready - follows best practices\n- ✅ Well-documented - clear examples and patterns\n\nUse OpenClaw+ whenever your task involves code execution, package management, version control, or web interactions - or any combination thereof!\n---","attachment_filenames":["_meta.json","CHANGELOG.md","evals/evals.json","manifest.json","PUBLISHING.md","QUICKSTART.md","README.md","REFERENCE.md","scripts/implementation.py","SUMMARY.md"],"attachments":[{"filename":"_meta.json","content":"{\n \"owner\": \"shindo957-official\",\n \"slug\": \"openclaw-plus\",\n \"displayName\": \"openclaw-plus\",\n \"latest\": {\n \"version\": \"1.0.0\",\n \"publishedAt\": 1771206008784,\n \"commit\": \"https://github.com/openclaw/skills/commit/ef35abcc93907e23c56a00b4cc2506f47a4eb96d\"\n },\n \"history\": []\n}\n","content_type":"application/json; charset=utf-8","language":"json","size":290,"content_sha256":"10379343b3571a4a1d34e769c5db6a73257fde3269355a82c7dec27e839ee9ba"},{"filename":"CHANGELOG.md","content":"# Changelog\n\nAll notable changes to OpenClaw+ will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [1.0.0] - 2026-02-15\n\n### 🎉 Initial Release\n\nFirst stable release of OpenClaw+, a modular super-skill combining developer and web capabilities.\n\n### ✨ Added\n\n#### Developer Capabilities\n- **run_python** - Execute Python code with proper environment management\n - Multi-line code support\n - Exception handling and error capture\n - Timeout protection (30s)\n - Access to installed packages\n \n- **install_package** - Install Python packages with dependency handling\n - Pip package installation with `--break-system-packages` flag\n - System package support (apt, brew)\n - Version pinning support\n - Requirements file support\n - Installation status feedback\n \n- **git_status** - Check repository status and track changes\n - Show modified, added, deleted files\n - Display untracked files\n - Current branch information\n - Clean/dirty state detection\n - Custom directory support\n \n- **git_commit** - Commit changes with meaningful messages\n - Conventional commit format support\n - Multi-line commit messages\n - Automatic staging option\n - Selective file staging\n - Commit hash capture\n\n#### Web Capabilities\n- **fetch_url** - Retrieve web content with robust error handling\n - HTTP/HTTPS support\n - Custom headers\n - Timeout configuration\n - Response parsing (JSON, XML, HTML, text)\n - Redirect following\n \n- **call_api** - Make API requests with authentication and response parsing\n - REST API support\n - Multiple HTTP methods (GET, POST, PUT, DELETE, PATCH)\n - Authentication (Bearer, API Key)\n - JSON request/response handling\n - Custom headers support\n - GraphQL support\n\n#### Documentation\n- Comprehensive SKILL.md with all capabilities documented\n- README.md with quick overview and use cases\n- QUICKSTART.md with step-by-step tutorials\n- REFERENCE.md with complete API specifications\n- SUMMARY.md with project overview\n\n#### Testing & Examples\n- 10 comprehensive test cases in evals.json\n- Reference Python implementation (implementation.py)\n- Multiple workflow pattern examples\n- Error handling demonstrations\n\n#### Workflow Patterns\n- Data Pipeline: Install → Fetch → Process → Commit\n- Web Scraping: Fetch → Parse → Store → Commit\n- API Testing: Call → Validate → Report → Commit\n- Multi-step automation examples\n\n### 📝 Documentation\n\n- Added complete API reference for all 6 capabilities\n- Added 15+ code examples across all capabilities\n- Added security guidelines and best practices\n- Added troubleshooting section\n- Added integration examples with other skills\n\n### 🔧 Implementation Details\n\n- Python 3.x compatible\n- Follows PEP 8 style guidelines\n- Conventional commit message format\n- MIT License\n- Modular, extensible architecture\n\n### 📦 Package Contents\n\n```\nopenclaw-plus/\n├── manifest.json # Skill metadata\n├── SKILL.md # Main skill documentation (20KB)\n├── README.md # Overview (3KB)\n├── QUICKSTART.md # Quick start guide (4KB)\n├── REFERENCE.md # API reference (15KB)\n├── CHANGELOG.md # This file\n├── SUMMARY.md # Project summary\n├── LICENSE.txt # MIT License\n├── evals/\n│ ├── evals.json # 10 test cases\n│ └── files/ # Test input files\n└── scripts/\n └── implementation.py # Reference implementation\n```\n\n### 🎯 Key Features\n\n- ✅ Modular design - use only what you need\n- ✅ Robust error handling at every step\n- ✅ Seamless workflow composition\n- ✅ Production-ready best practices\n- ✅ Extensive documentation with examples\n- ✅ Test coverage for all capabilities\n- ✅ Integration with other skills\n\n### 📊 Statistics\n\n- Total documentation: ~55KB\n- Implementation: ~600 lines of Python\n- Test cases: 10 comprehensive scenarios\n- Code examples: 30+ across all documentation\n- Workflow patterns: 10+ documented patterns\n\n### 🙏 Credits\n\nCreated by Shindo957 ([email protected])\n\n---\n\n## Future Roadmap\n\n### Planned for v1.1.0\n- [ ] Add database operations (SQLite, PostgreSQL)\n- [ ] Add file operations (zip, tar, compress)\n- [ ] Add environment variable management\n- [ ] Enhanced error recovery with retries\n- [ ] Async operation support\n\n### Planned for v1.2.0\n- [ ] Docker integration\n- [ ] Cloud service integration (AWS, GCP, Azure)\n- [ ] CI/CD pipeline support\n- [ ] Testing framework integration (pytest, unittest)\n- [ ] Code quality checks (linting, formatting)\n\n### Planned for v2.0.0\n- [ ] Plugin architecture for custom capabilities\n- [ ] Web scraping framework\n- [ ] Data transformation pipeline\n- [ ] Scheduled task execution\n- [ ] Notification system integration\n\n---\n\n## Version History\n\n- **1.0.0** (2026-02-15) - Initial release with 6 core capabilities\n\n---\n\n## Contributing\n\nWe welcome contributions! Areas for improvement:\n- Additional capabilities\n- More workflow patterns\n- Enhanced error handling\n- Additional test cases\n- Documentation improvements\n- Bug fixes and optimizations\n\nPlease submit issues and pull requests to help make OpenClaw+ even better!\n\n---\n\n## License\n\nOpenClaw+ is released under the MIT License. See LICENSE.txt for details.\n","content_type":"text/markdown; charset=utf-8","language":"markdown","size":5404,"content_sha256":"ebaccfffb96ed2ae511f3645f684c06ec30cfd3572f82a3ab02ee0bb74f2a23a"},{"filename":"evals/evals.json","content":"{\n \"evals\": [\n {\n \"id\": \"simple_python_execution\",\n \"prompt\": \"Run a simple Python script that calculates the factorial of 10 and prints the result.\",\n \"input_files\": [],\n \"expectations\": [\n \"Python code is executed successfully\",\n \"The factorial of 10 (3628800) is calculated and printed\",\n \"No errors occur during execution\"\n ]\n },\n {\n \"id\": \"package_install_and_use\",\n \"prompt\": \"Install the 'requests' package and use it to check if httpbin.org is accessible.\",\n \"input_files\": [],\n \"expectations\": [\n \"The requests package is installed using --break-system-packages flag\",\n \"A GET request is made to httpbin.org\",\n \"The response status is checked and reported\",\n \"No installation errors occur\"\n ]\n },\n {\n \"id\": \"git_workflow\",\n \"prompt\": \"Create a new file called 'test.txt' with some content, check git status, and commit the changes with a meaningful message.\",\n \"input_files\": [],\n \"expectations\": [\n \"A test.txt file is created with content\",\n \"git status is checked and shows the new file\",\n \"Changes are committed with a proper commit message\",\n \"The commit follows conventional commit format\"\n ]\n },\n {\n \"id\": \"api_data_fetch\",\n \"prompt\": \"Fetch data from JSONPlaceholder API (https://jsonplaceholder.typicode.com/posts/1) and save it to a file called 'post.json'.\",\n \"input_files\": [],\n \"expectations\": [\n \"The API is called successfully\",\n \"JSON response is received and parsed\",\n \"Data is saved to post.json file\",\n \"The file contains valid JSON with post data\"\n ]\n },\n {\n \"id\": \"web_scraping_simple\",\n \"prompt\": \"Fetch the HTML from example.com and extract the main heading text.\",\n \"input_files\": [],\n \"expectations\": [\n \"HTML is fetched from example.com\",\n \"The main heading is extracted\",\n \"The result is displayed to the user\",\n \"No network errors occur\"\n ]\n },\n {\n \"id\": \"data_pipeline\",\n \"prompt\": \"Install pandas, create a simple DataFrame with 3 rows of sample data (name, age, city), save it as CSV, then read it back and display summary statistics.\",\n \"input_files\": [],\n \"expectations\": [\n \"Pandas is installed successfully\",\n \"A DataFrame is created with the specified structure\",\n \"Data is saved to CSV file\",\n \"CSV is read back successfully\",\n \"Summary statistics are displayed\"\n ]\n },\n {\n \"id\": \"error_handling\",\n \"prompt\": \"Try to install a non-existent package called 'this-package-definitely-does-not-exist-xyz123' and handle the error gracefully.\",\n \"input_files\": [],\n \"expectations\": [\n \"The installation is attempted\",\n \"The error is caught and handled\",\n \"A clear error message is provided to the user\",\n \"The script doesn't crash\"\n ]\n },\n {\n \"id\": \"multi_step_workflow\",\n \"prompt\": \"Create a complete workflow: 1) Install matplotlib, 2) Generate a simple line plot and save as 'chart.png', 3) Create a file 'analysis.txt' describing the plot, 4) Check git status, 5) Commit both files.\",\n \"input_files\": [],\n \"expectations\": [\n \"Matplotlib is installed\",\n \"A line plot is generated and saved as chart.png\",\n \"An analysis.txt file is created with description\",\n \"Git status is checked\",\n \"Both files are committed together\",\n \"Commit message is meaningful\"\n ]\n },\n {\n \"id\": \"api_with_parameters\",\n \"prompt\": \"Call the GitHub API to get information about the 'python/cpython' repository (https://api.github.com/repos/python/cpython) and display the repository name, description, and star count.\",\n \"input_files\": [],\n \"expectations\": [\n \"GitHub API is called successfully\",\n \"JSON response is parsed\",\n \"Repository name, description, and stars are extracted\",\n \"Information is displayed in a readable format\"\n ]\n },\n {\n \"id\": \"combined_capabilities\",\n \"prompt\": \"Demonstrate all capabilities in one workflow: Install requests, fetch JSON from an API, process it with Python to extract specific fields, save results to a file, check git status, and commit the file.\",\n \"input_files\": [],\n \"expectations\": [\n \"All six capabilities are used (install_package, fetch_url OR call_api, run_python, create file, git_status, git_commit)\",\n \"Each step completes successfully\",\n \"The workflow is executed in logical order\",\n \"Final output is committed to git\"\n ]\n }\n ]\n}\n","content_type":"application/json; charset=utf-8","language":"json","size":4704,"content_sha256":"2ebf63820b8034a4869de2c8e41b0001d328e079ef58bfd3547d4bef4efa451f"},{"filename":"manifest.json","content":"{\n \"name\": \"openclaw-plus\",\n \"version\": \"1.0.0\",\n \"description\": \"A modular super-skill combining developer and web capabilities. Includes Python execution, package management, git operations, URL fetching, and API calls for seamless development workflows.\",\n \"author\": \"Shindo957 \[email protected]>\",\n \"tags\": [\"developer\", \"automation\", \"web\", \"git\", \"python\", \"api\", \"utility\", \"workflow\"],\n \"license\": \"MIT\"\n}\n","content_type":"application/json; charset=utf-8","language":"json","size":430,"content_sha256":"c2452752ca131f265271e1781552e8c26f8e041ee21e0de7d78ad94d0a74e212"},{"filename":"PUBLISHING.md","content":"# Publishing OpenClaw+ to ClawHub\n\n## Quick Fix - Updated Files\n\n✅ **SKILL.md has been updated** with the required `license` field in the YAML frontmatter.\n\nThe skill package now includes:\n- ✅ Proper YAML frontmatter with `name`, `description`, and `license` fields\n- ✅ manifest.json with metadata\n- ✅ LICENSE.txt file\n- ✅ All documentation and implementation files\n\n## Publishing Steps\n\n### 1. Use the `.skill` file (recommended)\n\nUpload `openclaw-plus.skill` to ClawHub. This is a zip archive with the `.skill` extension that ClawHub recognizes.\n\n### 2. Verify SKILL.md Format\n\nThe YAML frontmatter should look like this:\n```yaml\n---\nname: openclaw-plus\ndescription: A modular super-skill combining developer and web capabilities...\nlicense: Complete terms in LICENSE.txt\n---\n```\n\n### 3. Check File Structure\n\nYour `.skill` file should contain:\n```\nopenclaw-plus/\n├── SKILL.md (Required - with YAML frontmatter)\n├── manifest.json (Required)\n├── LICENSE.txt (Required)\n├── README.md\n├── CHANGELOG.md\n├── QUICKSTART.md\n├── REFERENCE.md\n├── SUMMARY.md\n├── evals/\n│ ├── evals.json\n│ └── files/\n└── scripts/\n └── implementation.py\n```\n\n## Troubleshooting\n\n### Issue: \"SKILL.md not detected\"\n\n**Solution 1: Check YAML Frontmatter**\n- Ensure YAML starts and ends with `---`\n- Must have `name`, `description`, and `license` fields\n- No extra spaces or formatting issues\n\n**Solution 2: Check File Location**\n- SKILL.md must be at `openclaw-plus/SKILL.md` (not at root)\n- File name must be exactly `SKILL.md` (all caps)\n\n**Solution 3: Use .skill Extension**\n- Upload `openclaw-plus.skill` instead of `openclaw-plus.zip`\n- ClawHub may prefer the `.skill` extension\n\n### Issue: \"Invalid skill format\"\n\n**Check:**\n1. YAML frontmatter is valid (no syntax errors)\n2. manifest.json is valid JSON\n3. LICENSE.txt exists\n4. All files are inside the `openclaw-plus/` directory\n\n### Issue: \"Missing required fields\"\n\n**Ensure YAML has:**\n```yaml\n---\nname: openclaw-plus\ndescription: [your description]\nlicense: Complete terms in LICENSE.txt\n---\n```\n\n### Issue: Upload fails\n\n**Try:**\n1. Use the `.skill` file instead of `.zip`\n2. Check file size (should be ~60KB compressed)\n3. Verify the zip structure with: `unzip -l openclaw-plus.skill`\n4. Re-download the file and try again\n\n## Validation Commands\n\nBefore uploading, verify the package:\n\n```bash\n# Check the file type\nfile openclaw-plus.skill\n# Should output: \"Zip archive data\"\n\n# List contents\nunzip -l openclaw-plus.skill\n# Should show openclaw-plus/SKILL.md\n\n# Extract and verify YAML\nunzip -p openclaw-plus.skill openclaw-plus/SKILL.md | head -10\n# Should show the YAML frontmatter\n\n# Verify manifest\nunzip -p openclaw-plus.skill openclaw-plus/manifest.json\n# Should show valid JSON\n```\n\n## What's Fixed\n\nIn this version:\n- ✅ Added `license: Complete terms in LICENSE.txt` to SKILL.md frontmatter\n- ✅ Created manifest.json with all required fields\n- ✅ Included LICENSE.txt file\n- ✅ Proper directory structure (files inside openclaw-plus/)\n- ✅ Both .zip and .skill files available\n\n## Files to Upload\n\nChoose one:\n- **openclaw-plus.skill** (recommended for ClawHub)\n- **openclaw-plus.zip** (alternative, but .skill is preferred)\n\nBoth contain the exact same content, just different file extensions.\n\n## After Publishing\n\nOnce published on ClawHub, users can install with:\n```bash\nopenclaw install openclaw-plus\n```\n\nOr:\n```bash\nopenclaw skill add openclaw-plus\n```\n\n## Need More Help?\n\nIf ClawHub still doesn't detect the skill:\n1. Check ClawHub's documentation for required fields\n2. Look at other published skills on ClawHub for examples\n3. Verify your ClawHub account has publishing permissions\n4. Try uploading through ClawHub's web interface vs CLI\n\n## Contact\n\nAuthor: Shindo957 ([email protected])\n\n---\n\nGood luck with publishing! 🚀\n","content_type":"text/markdown; charset=utf-8","language":"markdown","size":3931,"content_sha256":"c64b9eb5b268fb23bdd2d90fc461d1df89028b746944676b61d362a0e980b79b"},{"filename":"QUICKSTART.md","content":"# OpenClaw+ Quick Start Guide\n\nGet up and running with OpenClaw+ in minutes!\n\n## Installation\n\nOpenClaw+ is a skill for Claude. To use it, simply enable it in your Claude skills configuration.\n\n## Basic Usage\n\n### 1. Running Python Code\n\nThe simplest operation - execute Python code directly:\n\n```\nUser: \"Run Python code to calculate the first 10 Fibonacci numbers\"\n\nClaude will:\n1. Use run_python capability\n2. Execute the code\n3. Display results\n```\n\n### 2. Installing Packages\n\nBefore using external packages:\n\n```\nUser: \"Install numpy and create a random 3x3 matrix\"\n\nClaude will:\n1. Install numpy using install_package\n2. Run Python code to create and display the matrix\n```\n\n### 3. Git Operations\n\nTrack and commit your work:\n\n```\nUser: \"Create a file called notes.txt, check git status, and commit it\"\n\nClaude will:\n1. Create the file\n2. Use git_status to check changes\n3. Use git_commit to save changes\n```\n\n### 4. Fetching Web Content\n\nGet data from the web:\n\n```\nUser: \"Fetch the HTML from example.com and show me the title\"\n\nClaude will:\n1. Use fetch_url to get the page\n2. Parse and extract the title\n3. Display the result\n```\n\n### 5. Calling APIs\n\nInteract with web services:\n\n```\nUser: \"Get the first post from JSONPlaceholder API\"\n\nClaude will:\n1. Use call_api to fetch data\n2. Parse JSON response\n3. Display the post information\n```\n\n## Common Workflows\n\n### Data Analysis Pipeline\n\n```\nUser: \"Install pandas, create a sample sales dataset, analyze it, and save the results\"\n```\n\nOpenClaw+ will orchestrate:\n1. Package installation (install_package)\n2. Data creation and analysis (run_python)\n3. File saving\n4. Git operations to track changes (git_status, git_commit)\n\n### Web Scraping\n\n```\nUser: \"Install beautifulsoup4, scrape product data from example-shop.com, and save to a JSON file\"\n```\n\nOpenClaw+ will handle:\n1. Installing required packages\n2. Fetching the webpage\n3. Parsing and extracting data\n4. Saving results\n5. Committing to git\n\n### API Integration Testing\n\n```\nUser: \"Test our API endpoints and create a report of which ones are working\"\n```\n\nOpenClaw+ will execute:\n1. Make API calls to each endpoint\n2. Track successes and failures\n3. Generate a report\n4. Save and commit the report\n\n## Tips & Tricks\n\n### 1. Chain Operations\n\nOpenClaw+ excels at multi-step workflows:\n\n```\n\"Install matplotlib, generate a chart, create a README explaining it, and commit both files\"\n```\n\n### 2. Error Handling\n\nOpenClaw+ handles errors gracefully:\n\n```\n\"Try to install package-that-doesnt-exist and let me know if it fails\"\n```\n\n### 3. Combine with Other Skills\n\nOpenClaw+ works great with other Claude skills:\n\n```\n\"Fetch sales data from the API, process it with Python, and create an Excel report\"\n```\n(This uses OpenClaw+ for data fetching/processing and xlsx skill for the report)\n\n## Environment Notes\n\n### Python Environment\n\n- Default Python version: Check with `python --version`\n- Package manager: pip with `--break-system-packages` flag\n- Supported: Virtual environments (when needed)\n\n### Git Environment\n\n- Requires existing git repository\n- Commit messages follow conventional commit format\n- Supports staging specific files or all changes\n\n### Network Access\n\n- HTTP/HTTPS requests supported\n- Timeouts configurable (default 30s)\n- Authentication via headers or tokens\n\n## Troubleshooting\n\n### \"Package installation failed\"\n\n- Check package name spelling\n- Verify internet connectivity\n- Some packages require system dependencies\n\n### \"Not a git repository\"\n\n- Initialize git first: `git init`\n- Or work in an existing repository\n\n### \"Network error\"\n\n- Check URL is correct\n- Verify internet connectivity\n- Try with longer timeout\n\n### \"Python execution error\"\n\n- Check for syntax errors\n- Ensure required packages are installed\n- Review the full error message\n\n## Next Steps\n\n1. Review the [full documentation](SKILL.md)\n2. Check out the [examples](evals/evals.json)\n3. Try the [example implementation](scripts/implementation.py)\n4. Explore workflow patterns for your use case\n\n## Need Help?\n\n- Review error messages carefully\n- Check the documentation for specific capabilities\n- Try breaking complex workflows into smaller steps\n- Refer to example workflows in SKILL.md\n\n---\n\nHappy coding with OpenClaw+! 🚀\n","content_type":"text/markdown; charset=utf-8","language":"markdown","size":4247,"content_sha256":"9eb0c3f63bba7b7d14353de452bdbe3e384f15f9d7b3e3f3a10b4550467dd72d"},{"filename":"README.md","content":"# OpenClaw+ 🚀\n\nA modular super-skill for Claude that combines essential developer tools and web capabilities into a unified, powerful workflow.\n\n## What is OpenClaw+?\n\nOpenClaw+ is a comprehensive skill that integrates seven core capabilities:\n\n### Developer Skills\n- **run_python** - Execute Python code with proper environment management\n- **git_status** - Check repository status and track changes \n- **git_commit** - Commit changes with meaningful messages\n- **install_package** - Install Python packages with dependency handling\n\n### Web Skills\n- **fetch_url** - Retrieve web content with robust error handling\n- **call_api** - Make API requests with authentication and response parsing\n\n## Key Features\n\n✅ **Modular Design** - Use only what you need, when you need it\n✅ **Robust Error Handling** - Graceful failure recovery at every step\n✅ **Workflow Composition** - Chain operations seamlessly\n✅ **Production-Ready** - Follows industry best practices\n✅ **Well-Documented** - Clear examples and patterns\n\n## Common Use Cases\n\n### Data Pipeline\n```python\ninstall_package(\"pandas requests\")\ndata = call_api(\"https://api.example.com/dataset\")\nrun_python(\"process_data.py\")\ngit_commit(\"feat: add cleaned dataset\")\n```\n\n### Web Scraping & Analysis\n```python\ninstall_package(\"beautifulsoup4 lxml\")\nhtml = fetch_url(\"https://example.com/data\")\nrun_python(\"parse_and_analyze.py\")\ngit_commit(\"chore: update scraped data\")\n```\n\n### API Testing\n```python\ninstall_package(\"pytest requests\")\nrun_python(\"test_api_endpoints.py\")\ngit_commit(\"test: add API integration tests\")\n```\n\n## When to Use\n\nUse OpenClaw+ when your task involves:\n- Running Python scripts or code snippets\n- Installing Python packages\n- Checking git repository status\n- Committing code changes\n- Fetching content from URLs\n- Making API calls\n- Combining any of the above in a workflow\n\n## Installation\n\nThis skill is designed to be used with Claude's skill system. Simply reference it in your Claude configuration to enable all capabilities.\n\n## Documentation\n\nSee [SKILL.md](./SKILL.md) for complete documentation including:\n- Detailed capability reference\n- Workflow patterns and examples\n- Error handling guidelines\n- Security considerations\n- Best practices\n- Integration with other skills\n\n## License\n\nMIT License - see [LICENSE.txt](./LICENSE.txt) for details.\n\n## Contributing\n\nOpenClaw+ is designed to be extensible. Contributions are welcome for:\n- Additional capabilities\n- Improved error handling\n- More workflow patterns\n- Better documentation\n\n---\n\n**Created for developers who need powerful, integrated workflows with Claude** 🚀\n","content_type":"text/markdown; charset=utf-8","language":"markdown","size":2623,"content_sha256":"36bb89ec4acbfd17931d51453d9b103f86ceba8b5006f5014dbbb53dc1633398"},{"filename":"REFERENCE.md","content":"# OpenClaw+ Capability Reference\n\nComplete reference for all OpenClaw+ capabilities with detailed specifications.\n\n## Table of Contents\n\n1. [Python Execution](#python-execution)\n2. [Package Management](#package-management)\n3. [Git Operations](#git-operations)\n4. [URL Fetching](#url-fetching)\n5. [API Calls](#api-calls)\n\n---\n\n## Python Execution\n\n### `run_python(code: str) -> Dict`\n\nExecute Python code and capture output.\n\n**Parameters:**\n- `code` (str): Python code to execute\n\n**Returns:**\n```python\n{\n 'stdout': str, # Standard output\n 'stderr': str, # Standard error\n 'returncode': int, # Exit code (0 = success)\n 'success': bool # Whether execution succeeded\n}\n```\n\n**Example:**\n```python\nresult = run_python(\"\"\"\nimport math\nprint(f\"Pi is approximately {math.pi:.2f}\")\n\"\"\")\n\nif result['success']:\n print(result['stdout']) # \"Pi is approximately 3.14\"\nelse:\n print(f\"Error: {result['stderr']}\")\n```\n\n**Features:**\n- Multi-line code support\n- Exception handling\n- Timeout protection (30s)\n- Access to installed packages\n- Environment variable access\n\n**Limitations:**\n- No interactive input\n- Limited to 30 second execution\n- Runs in subprocess (no shared state)\n\n**Error Handling:**\n```python\ntry:\n result = run_python(\"invalid syntax here\")\n if not result['success']:\n print(f\"Execution failed: {result['stderr']}\")\nexcept Exception as e:\n print(f\"Unexpected error: {e}\")\n```\n\n---\n\n## Package Management\n\n### `install_package(package: str, system: bool = False) -> Dict`\n\nInstall Python or system packages.\n\n**Parameters:**\n- `package` (str): Package name or requirement specification\n- `system` (bool): Whether to install system package (default: False)\n\n**Returns:**\n```python\n{\n 'success': bool, # Whether installation succeeded\n 'output': str, # Installation output\n 'error': str # Error message if failed\n}\n```\n\n**Examples:**\n\nSimple package:\n```python\nresult = install_package(\"pandas\")\n```\n\nSpecific version:\n```python\nresult = install_package(\"numpy==1.24.0\")\n```\n\nMultiple packages:\n```python\nresult = install_package(\"requests beautifulsoup4 lxml\")\n```\n\nFrom requirements file:\n```python\nresult = install_package(\"-r requirements.txt\")\n```\n\nSystem package:\n```python\nresult = install_package(\"libpq-dev\", system=True)\n```\n\n**Implementation Details:**\n```bash\n# Python packages\npip install \u003cpackage> --break-system-packages\n\n# System packages (Ubuntu/Debian)\nsudo apt-get install -y \u003cpackage>\n```\n\n**Features:**\n- Dependency resolution\n- Version pinning\n- Requirements file support\n- System package installation\n- Progress feedback\n\n**Limitations:**\n- Requires internet connectivity\n- System packages need sudo access\n- Some packages require system dependencies\n- Timeout after 120 seconds\n\n**Best Practices:**\n```python\n# Check if already installed\nif not package_installed(\"pandas\"):\n install_package(\"pandas\")\n\n# Handle installation errors\nresult = install_package(\"my-package\")\nif not result['success']:\n print(f\"Installation failed: {result['error']}\")\n # Fallback or alternative approach\n```\n\n---\n\n## Git Operations\n\n### `git_status(path: str = '.') -> Dict`\n\nCheck git repository status.\n\n**Parameters:**\n- `path` (str): Path to git repository (default: current directory)\n\n**Returns:**\n```python\n{\n 'success': bool, # Whether operation succeeded\n 'status': str, # Raw git status output\n 'modified': List[str], # List of modified files\n 'untracked': List[str], # List of untracked files\n 'branch': str, # Current branch name\n 'clean': bool, # Whether working directory is clean\n 'error': str # Error message if failed (optional)\n}\n```\n\n**Example:**\n```python\nstatus = git_status()\n\nif status['success']:\n print(f\"Branch: {status['branch']}\")\n \n if status['clean']:\n print(\"Working directory is clean\")\n else:\n print(f\"Modified files: {', '.join(status['modified'])}\")\n print(f\"Untracked files: {', '.join(status['untracked'])}\")\nelse:\n print(f\"Error: {status['error']}\")\n```\n\n**Features:**\n- Parse status output\n- Identify file states\n- Show current branch\n- Detect clean/dirty state\n- Custom repository path\n\n**Limitations:**\n- Requires git repository\n- Only works with local repos\n- No remote status\n\n**Use Cases:**\n```python\n# Before committing\nstatus = git_status()\nif not status['clean']:\n # Files to commit\n files_to_commit = status['modified'] + status['untracked']\n \n# Check specific directory\nstatus = git_status(\"/path/to/repo\")\n```\n\n---\n\n### `git_commit(message: str, path: str = '.', stage_all: bool = False, files: List[str] = None) -> Dict`\n\nCommit changes to git repository.\n\n**Parameters:**\n- `message` (str): Commit message\n- `path` (str): Path to git repository (default: current directory)\n- `stage_all` (bool): Stage all changes before committing (default: False)\n- `files` (List[str]): Specific files to stage (optional)\n\n**Returns:**\n```python\n{\n 'success': bool, # Whether commit succeeded\n 'commit_hash': str, # SHA of the commit\n 'output': str, # Git output\n 'error': str # Error message if failed (optional)\n}\n```\n\n**Examples:**\n\nSimple commit:\n```python\nresult = git_commit(\"Add new feature\")\n```\n\nConventional commit:\n```python\nresult = git_commit(\"feat: add user authentication\")\n```\n\nMulti-line commit:\n```python\nresult = git_commit(\"\"\"\nfeat: add data processing pipeline\n\n- Implement CSV reader\n- Add data validation\n- Create output formatter\n\"\"\")\n```\n\nStage all and commit:\n```python\nresult = git_commit(\"fix: resolve bug\", stage_all=True)\n```\n\nCommit specific files:\n```python\nresult = git_commit(\"docs: update README\", files=[\"README.md\", \"CHANGELOG.md\"])\n```\n\n**Commit Message Format:**\n\nFollow conventional commit format:\n```\n\u003ctype>(\u003cscope>): \u003cdescription>\n\n[optional body]\n\n[optional footer]\n```\n\nTypes:\n- `feat`: New feature\n- `fix`: Bug fix\n- `docs`: Documentation changes\n- `style`: Code style changes\n- `refactor`: Code refactoring\n- `test`: Test changes\n- `chore`: Maintenance tasks\n\n**Features:**\n- Automatic staging\n- Selective file staging\n- Multi-line messages\n- Commit hash capture\n- Conventional commit support\n\n**Limitations:**\n- Requires git repository\n- Must have changes to commit\n- No interactive commits\n\n**Best Practices:**\n```python\n# Always check status first\nstatus = git_status()\nif not status['clean']:\n result = git_commit(\n \"feat: add new feature\",\n stage_all=True\n )\n \n if result['success']:\n print(f\"Committed: {result['commit_hash'][:7]}\")\n```\n\n---\n\n## URL Fetching\n\n### `fetch_url(url: str, timeout: int = 30, headers: Dict[str, str] = None) -> Dict`\n\nFetch content from a URL.\n\n**Parameters:**\n- `url` (str): URL to fetch\n- `timeout` (int): Request timeout in seconds (default: 30)\n- `headers` (Dict[str, str]): Optional HTTP headers\n\n**Returns:**\n```python\n{\n 'success': bool, # Whether fetch succeeded\n 'content': str, # Response content\n 'status_code': int, # HTTP status code\n 'headers': Dict[str, str],# Response headers\n 'error': str # Error message if failed (optional)\n}\n```\n\n**Examples:**\n\nSimple fetch:\n```python\nresult = fetch_url(\"https://example.com\")\nif result['success']:\n print(result['content'])\n```\n\nWith custom headers:\n```python\nresult = fetch_url(\n \"https://api.example.com/data\",\n headers={\n \"User-Agent\": \"OpenClaw+/1.0\",\n \"Accept\": \"application/json\"\n }\n)\n```\n\nWith timeout:\n```python\nresult = fetch_url(\"https://slow-site.com\", timeout=60)\n```\n\nParse HTML:\n```python\nresult = fetch_url(\"https://example.com\")\nif result['success']:\n from bs4 import BeautifulSoup\n soup = BeautifulSoup(result['content'], 'html.parser')\n title = soup.find('title').text\n```\n\n**Features:**\n- HTTP/HTTPS support\n- Custom headers\n- Timeout control\n- Response header access\n- Redirect following\n- SSL verification\n\n**Limitations:**\n- Text content only (no binary)\n- No POST/PUT/DELETE (use call_api)\n- No authentication (use call_api)\n- Single request (no retries built-in)\n\n**Error Handling:**\n```python\nresult = fetch_url(\"https://example.com\")\n\nif not result['success']:\n if 'timeout' in result['error'].lower():\n print(\"Request timed out\")\n elif 'status_code' in result:\n print(f\"HTTP error: {result['status_code']}\")\n else:\n print(f\"Network error: {result['error']}\")\n```\n\n**Use Cases:**\n```python\n# Fetch and parse JSON\nresult = fetch_url(\"https://api.example.com/data.json\")\nif result['success']:\n import json\n data = json.loads(result['content'])\n\n# Fetch HTML and extract data\nresult = fetch_url(\"https://news.example.com\")\nif result['success']:\n # Parse and extract headlines\n pass\n\n# Download text file\nresult = fetch_url(\"https://example.com/data.csv\")\nif result['success']:\n with open('data.csv', 'w') as f:\n f.write(result['content'])\n```\n\n---\n\n## API Calls\n\n### `call_api(url: str, method: str = 'GET', json_data: Dict = None, headers: Dict[str, str] = None, auth_token: str = None, timeout: int = 30) -> Dict`\n\nMake API requests with authentication and parsing.\n\n**Parameters:**\n- `url` (str): API endpoint URL\n- `method` (str): HTTP method (default: 'GET')\n- `json_data` (Dict): JSON data to send (optional)\n- `headers` (Dict[str, str]): Optional HTTP headers\n- `auth_token` (str): Optional Bearer token\n- `timeout` (int): Request timeout in seconds (default: 30)\n\n**Returns:**\n```python\n{\n 'success': bool, # Whether request succeeded\n 'data': Any, # Parsed response (JSON or text)\n 'status_code': int, # HTTP status code\n 'headers': Dict[str, str],# Response headers\n 'error': str # Error message if failed (optional)\n}\n```\n\n**Examples:**\n\nSimple GET:\n```python\nresult = call_api(\"https://api.example.com/users\")\nif result['success']:\n users = result['data']\n print(f\"Found {len(users)} users\")\n```\n\nWith authentication:\n```python\nresult = call_api(\n \"https://api.example.com/protected\",\n auth_token=\"your-api-token-here\"\n)\n```\n\nPOST request:\n```python\nresult = call_api(\n \"https://api.example.com/users\",\n method=\"POST\",\n json_data={\n \"name\": \"John Doe\",\n \"email\": \"[email protected]\"\n }\n)\n```\n\nPUT request:\n```python\nresult = call_api(\n \"https://api.example.com/users/123\",\n method=\"PUT\",\n json_data={\"name\": \"Jane Doe\"}\n)\n```\n\nDELETE request:\n```python\nresult = call_api(\n \"https://api.example.com/users/123\",\n method=\"DELETE\"\n)\n```\n\nCustom headers:\n```python\nresult = call_api(\n \"https://api.example.com/data\",\n headers={\n \"X-API-Key\": \"your-api-key\",\n \"X-Custom-Header\": \"value\"\n }\n)\n```\n\nGraphQL query:\n```python\nresult = call_api(\n \"https://api.example.com/graphql\",\n method=\"POST\",\n json_data={\n \"query\": \"\"\"\n query {\n users {\n id\n name\n email\n }\n }\n \"\"\"\n }\n)\n```\n\n**Features:**\n- Multiple HTTP methods\n- JSON request/response\n- Bearer token authentication\n- Custom headers\n- Automatic JSON parsing\n- Timeout control\n\n**Limitations:**\n- No file upload support\n- No OAuth flow\n- No retry logic (implement manually)\n- No rate limit handling (implement manually)\n\n**Authentication Patterns:**\n\nBearer token:\n```python\nresult = call_api(url, auth_token=\"token\")\n```\n\nAPI key in header:\n```python\nresult = call_api(\n url,\n headers={\"X-API-Key\": \"key\"}\n)\n```\n\nBasic auth:\n```python\nimport base64\nauth = base64.b64encode(b\"user:pass\").decode()\nresult = call_api(\n url,\n headers={\"Authorization\": f\"Basic {auth}\"}\n)\n```\n\n**Error Handling:**\n```python\nresult = call_api(\"https://api.example.com/endpoint\")\n\nif not result['success']:\n if result.get('status_code') == 401:\n print(\"Authentication failed\")\n elif result.get('status_code') == 429:\n print(\"Rate limit exceeded\")\n elif 'timeout' in result['error'].lower():\n print(\"Request timed out\")\n else:\n print(f\"API error: {result['error']}\")\n```\n\n**Pagination Example:**\n```python\nall_data = []\npage = 1\n\nwhile True:\n result = call_api(f\"https://api.example.com/data?page={page}\")\n \n if not result['success']:\n break\n \n data = result['data']\n if not data:\n break\n \n all_data.extend(data)\n page += 1\n\nprint(f\"Fetched {len(all_data)} total records\")\n```\n\n**Rate Limiting Example:**\n```python\nimport time\n\ndef call_with_retry(url, max_retries=3):\n for attempt in range(max_retries):\n result = call_api(url)\n \n if result['success']:\n return result\n \n if result.get('status_code') == 429:\n # Rate limited, wait and retry\n wait_time = 2 ** attempt # Exponential backoff\n print(f\"Rate limited, waiting {wait_time}s...\")\n time.sleep(wait_time)\n else:\n # Other error, don't retry\n return result\n \n return {'success': False, 'error': 'Max retries exceeded'}\n```\n\n---\n\n## Common Patterns\n\n### Pattern: Check Package → Install → Use\n\n```python\n# 1. Check if installed\nif not package_installed(\"requests\"):\n # 2. Install if needed\n result = install_package(\"requests\")\n if not result['success']:\n print(f\"Installation failed: {result['error']}\")\n return\n\n# 3. Use the package\nresult = call_api(\"https://api.example.com/data\")\n```\n\n### Pattern: Fetch → Process → Save → Commit\n\n```python\n# 1. Fetch data\nresult = call_api(\"https://api.example.com/data\")\nif not result['success']:\n print(f\"Fetch failed: {result['error']}\")\n return\n\n# 2. Process with Python\nprocess_result = run_python(\"\"\"\nimport json\n\nwith open('raw_data.json', 'r') as f:\n data = json.load(f)\n\n# Process data\nprocessed = [item for item in data if item['active']]\n\nwith open('processed_data.json', 'w') as f:\n json.dump(processed, f, indent=2)\n\"\"\")\n\n# 3. Check status\nstatus = git_status()\n\n# 4. Commit if changes\nif not status['clean']:\n git_commit(\"chore: update processed data\")\n```\n\n### Pattern: Error Recovery\n\n```python\n# Try primary method\nresult = fetch_url(\"https://primary-api.com/data\")\n\nif not result['success']:\n # Fallback to secondary\n result = fetch_url(\"https://secondary-api.com/data\")\n \n if not result['success']:\n # Final fallback\n print(\"Both APIs failed, using cached data\")\n with open('cached_data.json') as f:\n data = json.load(f)\n```\n\n---\n\n## Performance Tips\n\n1. **Package Installation**: Check if already installed before installing\n2. **API Calls**: Use appropriate timeouts, implement retries for transient failures\n3. **Python Execution**: For large operations, write to file first, then execute\n4. **Git Operations**: Check status before committing to avoid unnecessary operations\n5. **URL Fetching**: Set reasonable timeouts, handle large responses in chunks\n\n---\n\n## Security Guidelines\n\n1. **Never hardcode credentials** - Use environment variables or secure storage\n2. **Validate URLs** - Check URL format before fetching\n3. **Handle errors gracefully** - Don't expose sensitive information in error messages\n4. **Use HTTPS** - Prefer secure connections when available\n5. **Sanitize inputs** - Validate user inputs before passing to system commands\n","content_type":"text/markdown; charset=utf-8","language":"markdown","size":15371,"content_sha256":"4a72f8a47377c610f53016c2e8a50d8d205c6479817a8ed4b99549d54dbd980e"},{"filename":"scripts/implementation.py","content":"#!/usr/bin/env python3\n\"\"\"\nOpenClaw+ Implementation Examples\n\nThis script demonstrates how to implement each of the core capabilities\nin OpenClaw+. These are reference implementations that Claude can use\nwhen executing the skill.\n\"\"\"\n\nimport subprocess\nimport sys\nimport os\nimport json\nfrom typing import Optional, Dict, Any, List\n\n\nclass OpenClawPlus:\n \"\"\"Main class implementing OpenClaw+ capabilities\"\"\"\n \n def __init__(self):\n self.verbose = True\n \n def log(self, message: str):\n \"\"\"Log a message if verbose mode is enabled\"\"\"\n if self.verbose:\n print(f\"[OpenClaw+] {message}\")\n \n # ===== Python Execution =====\n \n def run_python(self, code: str, filename: Optional[str] = None) -> Dict[str, Any]:\n \"\"\"\n Execute Python code and return results.\n \n Args:\n code: Python code to execute\n filename: Optional filename to save code to before execution\n \n Returns:\n Dict with 'stdout', 'stderr', 'returncode', and 'success' keys\n \"\"\"\n self.log(\"Executing Python code...\")\n \n if filename:\n # Save code to file\n with open(filename, 'w') as f:\n f.write(code)\n cmd = [sys.executable, filename]\n else:\n # Execute directly\n cmd = [sys.executable, '-c', code]\n \n try:\n result = subprocess.run(\n cmd,\n capture_output=True,\n text=True,\n timeout=30\n )\n \n return {\n 'stdout': result.stdout,\n 'stderr': result.stderr,\n 'returncode': result.returncode,\n 'success': result.returncode == 0\n }\n except subprocess.TimeoutExpired:\n return {\n 'stdout': '',\n 'stderr': 'Execution timed out after 30 seconds',\n 'returncode': -1,\n 'success': False\n }\n except Exception as e:\n return {\n 'stdout': '',\n 'stderr': str(e),\n 'returncode': -1,\n 'success': False\n }\n \n # ===== Package Management =====\n \n def install_package(self, package: str, system: bool = False) -> Dict[str, Any]:\n \"\"\"\n Install a Python package using pip.\n \n Args:\n package: Package name or requirement specification\n system: Whether to install system package (apt/brew)\n \n Returns:\n Dict with 'success', 'output', and 'error' keys\n \"\"\"\n if system:\n self.log(f\"Installing system package: {package}\")\n # Attempt apt-get for Debian/Ubuntu systems\n cmd = ['sudo', 'apt-get', 'install', '-y', package]\n else:\n self.log(f\"Installing Python package: {package}\")\n # Always use --break-system-packages in this environment\n cmd = [sys.executable, '-m', 'pip', 'install', \n package, '--break-system-packages']\n \n try:\n result = subprocess.run(\n cmd,\n capture_output=True,\n text=True,\n timeout=120\n )\n \n return {\n 'success': result.returncode == 0,\n 'output': result.stdout,\n 'error': result.stderr\n }\n except subprocess.TimeoutExpired:\n return {\n 'success': False,\n 'output': '',\n 'error': 'Installation timed out after 120 seconds'\n }\n except Exception as e:\n return {\n 'success': False,\n 'output': '',\n 'error': str(e)\n }\n \n def package_installed(self, package: str) -> bool:\n \"\"\"Check if a Python package is installed\"\"\"\n cmd = [sys.executable, '-m', 'pip', 'show', package]\n result = subprocess.run(cmd, capture_output=True)\n return result.returncode == 0\n \n # ===== Git Operations =====\n \n def is_git_repo(self, path: str = '.') -> bool:\n \"\"\"Check if directory is a git repository\"\"\"\n git_dir = os.path.join(path, '.git')\n return os.path.isdir(git_dir)\n \n def git_status(self, path: str = '.') -> Dict[str, Any]:\n \"\"\"\n Get git repository status.\n \n Args:\n path: Path to git repository\n \n Returns:\n Dict with 'success', 'status', 'modified', 'untracked', 'branch' keys\n \"\"\"\n self.log(\"Checking git status...\")\n \n if not self.is_git_repo(path):\n return {\n 'success': False,\n 'error': 'Not a git repository'\n }\n \n try:\n # Get status\n result = subprocess.run(\n ['git', '-C', path, 'status', '--porcelain'],\n capture_output=True,\n text=True\n )\n \n # Get current branch\n branch_result = subprocess.run(\n ['git', '-C', path, 'branch', '--show-current'],\n capture_output=True,\n text=True\n )\n \n # Parse status output\n lines = result.stdout.strip().split('\\n') if result.stdout.strip() else []\n modified = [l[3:] for l in lines if l.startswith(' M')]\n untracked = [l[3:] for l in lines if l.startswith('??')]\n \n return {\n 'success': True,\n 'status': result.stdout,\n 'modified': modified,\n 'untracked': untracked,\n 'branch': branch_result.stdout.strip(),\n 'clean': len(lines) == 0\n }\n except Exception as e:\n return {\n 'success': False,\n 'error': str(e)\n }\n \n def git_commit(self, message: str, path: str = '.', \n stage_all: bool = False, files: Optional[List[str]] = None) -> Dict[str, Any]:\n \"\"\"\n Commit changes to git repository.\n \n Args:\n message: Commit message\n path: Path to git repository\n stage_all: Whether to stage all changes\n files: Specific files to stage\n \n Returns:\n Dict with 'success', 'commit_hash', 'output' keys\n \"\"\"\n self.log(f\"Committing changes: {message[:50]}...\")\n \n if not self.is_git_repo(path):\n return {\n 'success': False,\n 'error': 'Not a git repository'\n }\n \n try:\n # Stage files\n if stage_all:\n subprocess.run(['git', '-C', path, 'add', '-A'], check=True)\n elif files:\n for f in files:\n subprocess.run(['git', '-C', path, 'add', f], check=True)\n \n # Commit\n result = subprocess.run(\n ['git', '-C', path, 'commit', '-m', message],\n capture_output=True,\n text=True\n )\n \n if result.returncode != 0:\n return {\n 'success': False,\n 'error': result.stderr or 'Commit failed'\n }\n \n # Get commit hash\n hash_result = subprocess.run(\n ['git', '-C', path, 'rev-parse', 'HEAD'],\n capture_output=True,\n text=True\n )\n \n return {\n 'success': True,\n 'commit_hash': hash_result.stdout.strip(),\n 'output': result.stdout\n }\n except Exception as e:\n return {\n 'success': False,\n 'error': str(e)\n }\n \n # ===== Web Operations =====\n \n def fetch_url(self, url: str, timeout: int = 30, \n headers: Optional[Dict[str, str]] = None) -> Dict[str, Any]:\n \"\"\"\n Fetch content from a URL.\n \n Args:\n url: URL to fetch\n timeout: Request timeout in seconds\n headers: Optional HTTP headers\n \n Returns:\n Dict with 'success', 'content', 'status_code', 'error' keys\n \"\"\"\n self.log(f\"Fetching URL: {url}\")\n \n try:\n import requests\n except ImportError:\n return {\n 'success': False,\n 'error': 'requests package not installed'\n }\n \n try:\n response = requests.get(\n url,\n headers=headers or {},\n timeout=timeout\n )\n response.raise_for_status()\n \n return {\n 'success': True,\n 'content': response.text,\n 'status_code': response.status_code,\n 'headers': dict(response.headers)\n }\n except requests.Timeout:\n return {\n 'success': False,\n 'error': f'Request timed out after {timeout} seconds'\n }\n except requests.HTTPError as e:\n return {\n 'success': False,\n 'error': f'HTTP error: {e.response.status_code}',\n 'status_code': e.response.status_code\n }\n except Exception as e:\n return {\n 'success': False,\n 'error': str(e)\n }\n \n def call_api(self, url: str, method: str = 'GET', \n json_data: Optional[Dict] = None,\n headers: Optional[Dict[str, str]] = None,\n auth_token: Optional[str] = None,\n timeout: int = 30) -> Dict[str, Any]:\n \"\"\"\n Make an API request.\n \n Args:\n url: API endpoint URL\n method: HTTP method (GET, POST, PUT, DELETE, PATCH)\n json_data: JSON data to send\n headers: Optional HTTP headers\n auth_token: Optional Bearer token\n timeout: Request timeout in seconds\n \n Returns:\n Dict with 'success', 'data', 'status_code', 'error' keys\n \"\"\"\n self.log(f\"Calling API: {method} {url}\")\n \n try:\n import requests\n except ImportError:\n return {\n 'success': False,\n 'error': 'requests package not installed'\n }\n \n # Prepare headers\n req_headers = headers or {}\n if auth_token:\n req_headers['Authorization'] = f'Bearer {auth_token}'\n \n try:\n response = requests.request(\n method=method,\n url=url,\n headers=req_headers,\n json=json_data,\n timeout=timeout\n )\n response.raise_for_status()\n \n # Try to parse JSON\n try:\n data = response.json()\n except ValueError:\n data = response.text\n \n return {\n 'success': True,\n 'data': data,\n 'status_code': response.status_code,\n 'headers': dict(response.headers)\n }\n except requests.Timeout:\n return {\n 'success': False,\n 'error': f'Request timed out after {timeout} seconds'\n }\n except requests.HTTPError as e:\n return {\n 'success': False,\n 'error': f'HTTP error: {e.response.status_code}',\n 'status_code': e.response.status_code\n }\n except Exception as e:\n return {\n 'success': False,\n 'error': str(e)\n }\n\n\n# ===== Example Usage =====\n\ndef example_workflow():\n \"\"\"Example workflow demonstrating all capabilities\"\"\"\n \n oc = OpenClawPlus()\n \n print(\"=== OpenClaw+ Example Workflow ===\\n\")\n \n # 1. Install package\n print(\"1. Installing requests package...\")\n result = oc.install_package(\"requests\")\n if result['success']:\n print(\" ✓ Package installed successfully\")\n else:\n print(f\" ✗ Installation failed: {result['error']}\")\n \n # 2. Fetch URL\n print(\"\\n2. Fetching URL...\")\n result = oc.fetch_url(\"https://httpbin.org/get\")\n if result['success']:\n print(f\" ✓ Fetched {len(result['content'])} bytes\")\n else:\n print(f\" ✗ Fetch failed: {result['error']}\")\n \n # 3. Call API\n print(\"\\n3. Calling API...\")\n result = oc.call_api(\"https://jsonplaceholder.typicode.com/posts/1\")\n if result['success']:\n print(f\" ✓ API returned data: {result['data'].get('title', 'N/A')[:50]}\")\n else:\n print(f\" ✗ API call failed: {result['error']}\")\n \n # 4. Run Python\n print(\"\\n4. Running Python code...\")\n code = \"\"\"\nimport sys\nprint(f\"Python {sys.version.split()[0]}\")\nprint(\"Hello from OpenClaw+!\")\n \"\"\"\n result = oc.run_python(code)\n if result['success']:\n print(f\" ✓ Code executed:\\n{result['stdout']}\")\n else:\n print(f\" ✗ Execution failed: {result['stderr']}\")\n \n # 5. Git status\n print(\"\\n5. Checking git status...\")\n result = oc.git_status()\n if result['success']:\n if result['clean']:\n print(\" ✓ Working directory is clean\")\n else:\n print(f\" ✓ {len(result['modified'])} modified, {len(result['untracked'])} untracked\")\n else:\n print(f\" ℹ {result.get('error', 'Unknown error')}\")\n \n print(\"\\n=== Workflow Complete ===\")\n\n\nif __name__ == '__main__':\n example_workflow()\n","content_type":"text/x-python; charset=utf-8","language":"python","size":13934,"content_sha256":"12b33c461010fe83bf30fb13bd66fb9a4828e882058bca02b9185e9067581bee"},{"filename":"SUMMARY.md","content":"# OpenClaw+ Skill - Summary\n\n## What Was Created\n\nOpenClaw+ is a comprehensive, modular super-skill that combines developer tools and web capabilities. The skill has been fully implemented with:\n\n### Core Files\n\n1. **SKILL.md** (20KB) - Complete skill documentation\n - Overview and capabilities\n - Detailed usage instructions for each capability\n - Workflow patterns and examples\n - Error handling guidelines\n - Security considerations\n - Integration with other skills\n\n2. **README.md** (3KB) - Quick overview and getting started\n - What is OpenClaw+\n - Key features\n - Common use cases\n - Installation instructions\n\n3. **QUICKSTART.md** (4KB) - Quick start guide\n - Basic usage examples\n - Common workflows\n - Tips and tricks\n - Troubleshooting\n\n4. **REFERENCE.md** (15KB) - Complete API reference\n - Detailed specifications for each capability\n - Parameters and return values\n - Code examples\n - Common patterns\n - Performance tips\n\n5. **LICENSE.txt** (1KB) - MIT License\n\n### Supporting Files\n\n6. **evals/evals.json** - 10 test cases covering:\n - Simple Python execution\n - Package installation and usage\n - Git workflows\n - API data fetching\n - Web scraping\n - Data pipelines\n - Error handling\n - Multi-step workflows\n - API with parameters\n - Combined capabilities\n\n7. **scripts/implementation.py** (12KB) - Reference implementation\n - Complete Python class implementing all capabilities\n - Example workflow demonstrating integration\n - Error handling patterns\n - Executable demonstration\n\n## Capabilities Included\n\n### Developer Skills (4)\n1. ✅ **run_python** - Execute Python code with output capture\n2. ✅ **git_status** - Check repository status and track changes\n3. ✅ **git_commit** - Commit changes with meaningful messages\n4. ✅ **install_package** - Install Python packages with dependency handling\n\n### Web Skills (2)\n5. ✅ **fetch_url** - Retrieve web content with error handling\n6. ✅ **call_api** - Make API requests with authentication\n\n## Key Features\n\n- **Modular Design**: Use individual capabilities or combine them\n- **Error Handling**: Robust error recovery at every step\n- **Workflow Composition**: Chain operations seamlessly\n- **Production-Ready**: Follows best practices and conventions\n- **Well-Documented**: Extensive examples and clear explanations\n- **Test Coverage**: 10 comprehensive test cases\n- **Reference Implementation**: Working Python code demonstrating all features\n\n## File Structure\n\n```\nopenclaw-plus/\n├── SKILL.md # Main skill documentation (20KB)\n├── README.md # Overview and getting started (3KB)\n├── QUICKSTART.md # Quick start guide (4KB)\n├── REFERENCE.md # Complete API reference (15KB)\n├── LICENSE.txt # MIT License (1KB)\n├── evals/\n│ ├── evals.json # 10 test cases\n│ └── files/ # Test input files (empty initially)\n└── scripts/\n └── implementation.py # Reference implementation (12KB)\n```\n\n## Documentation Highlights\n\n### SKILL.md\n- Comprehensive overview of all 6 capabilities\n- 10+ detailed workflow patterns\n- Error handling strategies for each capability\n- Security considerations\n- Integration examples with other skills\n- 3 complete end-to-end examples\n\n### REFERENCE.md\n- Full API specification for each capability\n- Parameter descriptions and return types\n- Multiple code examples per capability\n- Common patterns and best practices\n- Performance tips\n- Security guidelines\n\n### Implementation\n- Working Python class with all capabilities\n- Proper error handling\n- Type hints and docstrings\n- Example workflow demonstration\n- Can be executed standalone\n\n## Usage Examples\n\n### Simple Example\n```python\n# Install pandas and analyze data\ninstall_package(\"pandas\")\nrun_python(\"data_analysis.py\")\n```\n\n### Complex Example\n```python\n# Complete data pipeline\ninstall_package(\"requests pandas\")\ndata = call_api(\"https://api.example.com/data\")\nrun_python(\"process_data.py\")\ngit_commit(\"feat: add cleaned dataset\")\n```\n\n## Test Coverage\n\nThe 10 test cases cover:\n- ✅ Individual capability testing (6 tests)\n- ✅ Error handling (1 test)\n- ✅ Multi-step workflows (2 tests)\n- ✅ Combined capability integration (1 test)\n\n## Next Steps\n\nTo use this skill:\n\n1. **Review Documentation**: Start with README.md, then SKILL.md\n2. **Try Examples**: Run the examples from QUICKSTART.md\n3. **Run Tests**: Use the evals.json test cases to validate\n4. **Customize**: Modify for your specific use cases\n\n## Notes\n\n- All files use markdown for documentation\n- Python implementation follows PEP 8 style\n- Commit messages follow conventional commit format\n- Code includes comprehensive error handling\n- Examples are production-ready\n\nTotal Size: ~55KB of documentation + implementation\nLines of Code: ~600 (implementation.py)\nTest Cases: 10 comprehensive scenarios\n","content_type":"text/markdown; charset=utf-8","language":"markdown","size":4921,"content_sha256":"f2b9952e9e975652bfe4b8a3812162ddb3ebfffb19cda35a9fd1736d25599762"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"OpenClaw+ 🚀","type":"text"}]},{"type":"paragraph","content":[{"text":"A modular super-skill that combines essential developer tools and web capabilities into a unified, powerful workflow.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"OpenClaw+ integrates seven core capabilities into one streamlined skill:","type":"text"}]},{"type":"paragraph","content":[{"text":"Developer Skills:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"run_python","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Execute Python code with proper environment management","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"git_status","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Check repository status and track changes","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"git_commit","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Commit changes with meaningful messages","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"install_package","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Install Python packages with dependency handling","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Web Skills:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"fetch_url","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Retrieve web content with robust error handling","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"call_api","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Make API requests with authentication and response parsing","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This modular design allows you to chain operations efficiently - install packages, run code, fetch data, commit results - all in one cohesive workflow.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"When to Use OpenClaw+","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this skill when the user's request involves:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Running Python scripts or code snippets","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Installing Python packages (pip, conda, system packages)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Checking git repository status","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Committing code changes","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Fetching content from URLs","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Making API calls (REST, GraphQL, etc.)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Combining any of the above in a workflow","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Common patterns:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Install pandas and run this analysis\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Fetch data from this API and save it\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Check git status and commit my changes\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Run this script and call this endpoint\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Install these packages, run the code, then commit\"","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Core Capabilities","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. Python Execution (","type":"text"},{"text":"run_python","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]},{"type":"paragraph","content":[{"text":"Execute Python code with proper environment management and output capture.","type":"text"}]},{"type":"paragraph","content":[{"text":"Key features:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Captures stdout, stderr, and return values","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Handles exceptions gracefully","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Supports multi-line scripts","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Access to installed packages","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Environment variable support","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Usage patterns:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"# Simple execution\nresult = run_python(\"print('Hello, world!')\")\n\n# With installed packages\nrun_python(\"\"\"\nimport pandas as pd\nimport numpy as np\n\ndata = pd.DataFrame({'a': [1, 2, 3], 'b': [4, 5, 6]})\nprint(data.describe())\n\"\"\")\n\n# File operations\nrun_python(\"\"\"\nwith open('output.txt', 'w') as f:\n f.write('Results: ...')\n\"\"\")","type":"text"}]},{"type":"paragraph","content":[{"text":"Best practices:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Always check for syntax errors before execution","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Handle file paths carefully (use absolute paths when needed)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Capture exceptions and provide clear error messages","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"For large scripts, consider creating a .py file first","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. Package Installation (","type":"text"},{"text":"install_package","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]},{"type":"paragraph","content":[{"text":"Install Python packages with intelligent dependency resolution.","type":"text"}]},{"type":"paragraph","content":[{"text":"Key features:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Pip package installation","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"System package support (apt, brew, etc.)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Conda environment support","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Dependency conflict detection","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Version pinning","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Usage patterns:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Install single package\ninstall_package(\"pandas\")\n\n# Install specific version\ninstall_package(\"numpy==1.24.0\")\n\n# Install multiple packages\ninstall_package(\"requests beautifulsoup4 lxml\")\n\n# Install from requirements.txt\ninstall_package(\"-r requirements.txt\")\n\n# System packages (when needed)\ninstall_package(\"libpq-dev\", system=True)","type":"text"}]},{"type":"paragraph","content":[{"text":"Best practices:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Always use ","type":"text"},{"text":"--break-system-packages","type":"text","marks":[{"type":"code_inline"}]},{"text":" flag for pip in this environment","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check if package is already installed before installing","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Handle version conflicts explicitly","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Provide clear feedback on installation success/failure","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Implementation:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"pip install \u003cpackage> --break-system-packages","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"3. Git Status (","type":"text"},{"text":"git_status","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]},{"type":"paragraph","content":[{"text":"Check repository status and track changes.","type":"text"}]},{"type":"paragraph","content":[{"text":"Key features:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Shows modified, added, deleted files","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Displays untracked files","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Shows current branch","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Indicates if ahead/behind remote","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Supports custom git directories","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Usage patterns:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Check current directory\ngit_status()\n\n# Check specific directory\ngit_status(\"/path/to/repo\")\n\n# Parse output for automation\nstatus = git_status()\nif \"modified:\" in status:\n print(\"Changes detected\")","type":"text"}]},{"type":"paragraph","content":[{"text":"Best practices:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Always check status before committing","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Parse output to detect specific changes","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Handle cases where directory isn't a git repo","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Provide context about what changed","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Implementation:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"git status\ngit diff --stat\ngit log -1 --oneline","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"4. Git Commit (","type":"text"},{"text":"git_commit","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]},{"type":"paragraph","content":[{"text":"Commit changes with meaningful messages following best practices.","type":"text"}]},{"type":"paragraph","content":[{"text":"Key features:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Conventional commit format support","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Multi-line commit messages","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Automatic staging option","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Commit message validation","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Amend support","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Usage patterns:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Simple commit\ngit_commit(\"Add new feature\")\n\n# Conventional commit\ngit_commit(\"feat: add user authentication\")\n\n# Multi-line with description\ngit_commit(\"\"\"\nfeat: add data processing pipeline\n\n- Implement CSV reader\n- Add data validation\n- Create output formatter\n\"\"\")\n\n# Stage and commit\ngit_commit(\"fix: resolve parsing error\", stage_all=True)","type":"text"}]},{"type":"paragraph","content":[{"text":"Best practices:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use conventional commit format: ","type":"text"},{"text":"type(scope): description","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Types: feat, fix, docs, style, refactor, test, chore","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Keep first line under 50 characters","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Add detailed description if needed","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Reference issue numbers when applicable","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Implementation:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"git add \u003cfiles> # if stage_all\ngit commit -m \"\u003cmessage>\"\ngit log -1 --oneline # confirm commit","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"5. URL Fetching (","type":"text"},{"text":"fetch_url","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]},{"type":"paragraph","content":[{"text":"Retrieve content from URLs with robust error handling.","type":"text"}]},{"type":"paragraph","content":[{"text":"Key features:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"HTTP/HTTPS support","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Custom headers","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Authentication support","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Redirect following","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Timeout handling","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Response parsing (JSON, XML, HTML, text)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Usage patterns:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"# Fetch HTML\nhtml = fetch_url(\"https://example.com\")\n\n# Fetch JSON\ndata = fetch_url(\"https://api.example.com/data\", \n parse_json=True)\n\n# With authentication\ncontent = fetch_url(\"https://api.example.com/protected\",\n headers={\"Authorization\": \"Bearer TOKEN\"})\n\n# With custom timeout\ncontent = fetch_url(\"https://slow-site.com\", timeout=30)\n\n# POST request\nresponse = fetch_url(\"https://api.example.com/submit\",\n method=\"POST\",\n data={\"key\": \"value\"})","type":"text"}]},{"type":"paragraph","content":[{"text":"Best practices:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Always handle network errors gracefully","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Set appropriate timeouts","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Validate URLs before fetching","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Parse response based on content type","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Handle rate limiting","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Respect robots.txt","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Implementation:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"import requests\n\nresponse = requests.get(url, headers=headers, timeout=timeout)\nresponse.raise_for_status()\nreturn response.text # or response.json()","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"6. API Calls (","type":"text"},{"text":"call_api","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]},{"type":"paragraph","content":[{"text":"Make API requests with authentication and response parsing.","type":"text"}]},{"type":"paragraph","content":[{"text":"Key features:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"REST API support","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GraphQL support","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Authentication (Bearer, Basic, API Key)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Request/response logging","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Error handling with retries","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Response validation","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Usage patterns:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"# Simple GET request\ndata = call_api(\"https://api.example.com/users\")\n\n# With authentication\ndata = call_api(\"https://api.example.com/data\",\n auth_token=\"your-token\")\n\n# POST with JSON body\nresult = call_api(\"https://api.example.com/create\",\n method=\"POST\",\n json_data={\"name\": \"John\", \"age\": 30})\n\n# With custom headers\ndata = call_api(\"https://api.example.com/endpoint\",\n headers={\"X-Custom-Header\": \"value\"})\n\n# GraphQL query\nresult = call_api(\"https://api.example.com/graphql\",\n method=\"POST\",\n json_data={\n \"query\": \"{ users { id name } }\"\n })","type":"text"}]},{"type":"paragraph","content":[{"text":"Best practices:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Validate API keys/tokens before use","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Handle rate limits with exponential backoff","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Parse response format (JSON, XML, etc.)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Log requests for debugging","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Handle pagination for large datasets","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Validate response schemas","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use appropriate HTTP methods (GET, POST, PUT, DELETE, PATCH)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Implementation:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"import requests\n\nheaders = {\"Authorization\": f\"Bearer {token}\"}\nresponse = requests.request(\n method=method,\n url=url,\n headers=headers,\n json=json_data,\n timeout=30\n)\nresponse.raise_for_status()\nreturn response.json()","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Workflow Patterns","type":"text"}]},{"type":"paragraph","content":[{"text":"OpenClaw+ shines when combining multiple capabilities:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Pattern 1: Data Pipeline","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"# 1. Install dependencies\ninstall_package(\"pandas requests\")\n\n# 2. Fetch data from API\ndata = call_api(\"https://api.example.com/dataset\")\n\n# 3. Process with Python\nrun_python(\"\"\"\nimport pandas as pd\nimport json\n\nwith open('raw_data.json', 'r') as f:\n data = json.load(f)\n\ndf = pd.DataFrame(data)\ndf_cleaned = df.dropna()\ndf_cleaned.to_csv('cleaned_data.csv', index=False)\nprint(f'Processed {len(df_cleaned)} records')\n\"\"\")\n\n# 4. Commit results\ngit_commit(\"feat: add cleaned dataset\")","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Pattern 2: Web Scraping & Analysis","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"# 1. Install scraping tools\ninstall_package(\"beautifulsoup4 lxml requests\")\n\n# 2. Fetch webpage\nhtml = fetch_url(\"https://example.com/data-page\")\n\n# 3. Parse and analyze\nrun_python(\"\"\"\nfrom bs4 import BeautifulSoup\nimport json\n\nwith open('page.html', 'r') as f:\n soup = BeautifulSoup(f, 'lxml')\n\ndata = []\nfor item in soup.find_all('div', class_='data-item'):\n data.append({\n 'title': item.find('h2').text,\n 'value': item.find('span', class_='value').text\n })\n\nwith open('scraped_data.json', 'w') as f:\n json.dump(data, f, indent=2)\n\"\"\")\n\n# 4. Check and commit\ngit_status()\ngit_commit(\"chore: update scraped data\")","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Pattern 3: API Integration Testing","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"# 1. Install testing tools\ninstall_package(\"pytest requests-mock\")\n\n# 2. Run tests\nrun_python(\"\"\"\nimport requests\nimport json\n\n# Test API endpoint\nresponse = requests.get('https://api.example.com/health')\nassert response.status_code == 200\n\n# Test with authentication\nheaders = {'Authorization': 'Bearer test-token'}\nresponse = requests.get('https://api.example.com/data', headers=headers)\nprint(f'Status: {response.status_code}')\nprint(f'Data: {response.json()}')\n\"\"\")\n\n# 3. Commit test results\ngit_commit(\"test: add API integration tests\")","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Pattern 4: Automated Reporting","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"# 1. Fetch data from multiple sources\napi_data = call_api(\"https://api.example.com/metrics\")\nweb_data = fetch_url(\"https://example.com/reports/latest\")\n\n# 2. Process and generate report\ninstall_package(\"matplotlib pandas\")\nrun_python(\"\"\"\nimport pandas as pd\nimport matplotlib.pyplot as plt\nimport json\n\nwith open('api_data.json', 'r') as f:\n data = json.load(f)\n\ndf = pd.DataFrame(data)\ndf['date'] = pd.to_datetime(df['date'])\n\nplt.figure(figsize=(10, 6))\nplt.plot(df['date'], df['value'])\nplt.title('Metrics Over Time')\nplt.savefig('report.png')\nprint('Report generated')\n\"\"\")\n\n# 3. Commit report\ngit_commit(\"docs: add automated metrics report\")","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Error Handling","type":"text"}]},{"type":"paragraph","content":[{"text":"Each capability includes robust error handling:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Python Execution Errors","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"try:\n result = run_python(code)\nexcept SyntaxError as e:\n print(f\"Syntax error: {e}\")\nexcept RuntimeError as e:\n print(f\"Runtime error: {e}\")","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Package Installation Errors","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Handle already installed\nif package_installed(\"pandas\"):\n print(\"Package already installed\")\nelse:\n install_package(\"pandas\")\n\n# Handle installation failure\ntry:\n install_package(\"nonexistent-package\")\nexcept Exception as e:\n print(f\"Installation failed: {e}\")","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Git Operation Errors","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Not a git repository\nif not is_git_repo():\n print(\"Not a git repository\")\n exit(1)\n\n# Nothing to commit\nstatus = git_status()\nif \"nothing to commit\" in status:\n print(\"No changes to commit\")","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Network Errors","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"# Handle timeouts\ntry:\n data = fetch_url(url, timeout=5)\nexcept TimeoutError:\n print(\"Request timed out\")\n\n# Handle HTTP errors\ntry:\n response = call_api(url)\nexcept requests.HTTPError as e:\n print(f\"HTTP error: {e.response.status_code}\")","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Best Practices","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. ","type":"text"},{"text":"Environment Management","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Always use ","type":"text"},{"text":"--break-system-packages","type":"text","marks":[{"type":"code_inline"}]},{"text":" for pip","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check if packages are installed before installing","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use virtual environments when appropriate","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Document package versions","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. ","type":"text"},{"text":"Git Operations","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check status before committing","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use meaningful commit messages","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Follow conventional commit format","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Stage only relevant files","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3. ","type":"text"},{"text":"Code Execution","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Validate syntax before running","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Handle exceptions gracefully","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Capture and log output","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Clean up temporary files","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4. ","type":"text"},{"text":"API/Web Requests","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Set appropriate timeouts","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Handle rate limiting","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Validate responses","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Log requests for debugging","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Respect API usage limits","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5. ","type":"text"},{"text":"Workflow Composition","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Chain operations logically","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Handle errors at each step","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Provide progress feedback","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Document dependencies","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Security Considerations","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API Keys & Credentials","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Never hardcode credentials","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use environment variables","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Validate before use","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Rotate regularly","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Code Execution","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Validate input code","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Sandbox when possible","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Limit resource usage","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Monitor execution","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Web Requests","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Validate URLs","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use HTTPS when possible","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Handle redirects carefully","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Respect robots.txt","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Debugging & Troubleshooting","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Common Issues","type":"text"}]},{"type":"paragraph","content":[{"text":"Python execution fails:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check syntax with ","type":"text"},{"text":"python -m py_compile script.py","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Verify packages are installed","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check file paths","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Review error messages","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Package installation fails:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Ensure pip is up to date","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check internet connectivity","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Verify package name","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Review dependencies","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Git operations fail:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Verify it's a git repository","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check file permissions","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Ensure clean working directory","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Review git configuration","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"API/URL requests fail:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Verify URL is correct","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check authentication","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Review rate limits","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check network connectivity","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example 1: Complete Data Pipeline","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"# User request: \"Fetch weather data, analyze it, and commit results\"\n\n# Step 1: Install dependencies\ninstall_package(\"requests pandas matplotlib\")\n\n# Step 2: Fetch data\nweather_data = call_api(\n \"https://api.weather.com/data\",\n auth_token=\"your-api-key\"\n)\n\n# Step 3: Save and analyze\nrun_python(\"\"\"\nimport pandas as pd\nimport matplotlib.pyplot as plt\nimport json\n\n# Load data\nwith open('weather_data.json', 'r') as f:\n data = json.load(f)\n\n# Create DataFrame\ndf = pd.DataFrame(data['forecast'])\ndf['date'] = pd.to_datetime(df['date'])\n\n# Analyze\navg_temp = df['temperature'].mean()\nmax_temp = df['temperature'].max()\nmin_temp = df['temperature'].min()\n\n# Generate plot\nplt.figure(figsize=(12, 6))\nplt.plot(df['date'], df['temperature'], marker='o')\nplt.title('Temperature Forecast')\nplt.xlabel('Date')\nplt.ylabel('Temperature (°F)')\nplt.grid(True)\nplt.savefig('temperature_forecast.png')\n\n# Save summary\nsummary = {\n 'avg_temp': avg_temp,\n 'max_temp': max_temp,\n 'min_temp': min_temp,\n 'records': len(df)\n}\n\nwith open('weather_summary.json', 'w') as f:\n json.dump(summary, f, indent=2)\n\nprint(f'Analysis complete: {len(df)} records processed')\nprint(f'Average temperature: {avg_temp:.1f}°F')\n\"\"\")\n\n# Step 4: Commit results\ngit_status()\ngit_commit(\"\"\"\nfeat: add weather data analysis\n\n- Fetch 7-day forecast from API\n- Generate temperature plot\n- Create summary statistics\n\"\"\")","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example 2: Web Scraping & Storage","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"python"},"content":[{"text":"# User request: \"Scrape product data and save to database\"\n\n# Step 1: Install tools\ninstall_package(\"beautifulsoup4 lxml requests sqlite3\")\n\n# Step 2: Fetch webpage\nhtml = fetch_url(\"https://example-shop.com/products\")\n\n# Step 3: Parse and store\nrun_python(\"\"\"\nfrom bs4 import BeautifulSoup\nimport sqlite3\nimport json\n\n# Parse HTML\nwith open('products.html', 'r') as f:\n soup = BeautifulSoup(f, 'lxml')\n\nproducts = []\nfor item in soup.find_all('div', class_='product'):\n product = {\n 'name': item.find('h3').text.strip(),\n 'price': float(item.find('span', class_='price').text.strip('

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.