{"id":47950365,"url":"https://github.com/aloth/PowerSkills","last_synced_at":"2026-04-19T16:01:03.367Z","repository":{"id":342661231,"uuid":"1174652190","full_name":"aloth/PowerSkills","owner":"aloth","description":"PowerShell automation toolkit for AI agents - Outlook, Edge browser, desktop, and system control via structured JSON.","archived":false,"fork":false,"pushed_at":"2026-03-07T08:14:50.000Z","size":241,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-07T10:49:55.931Z","etag":null,"topics":["agent-skills","ai-agent","ai-tools","automation","browser-automation","cdp","cli","com-automation","desktop-automation","devtools-protocol","edge-browser","json-api","llm-tools","outlook","powershell","powershell-module","powershell-script","system-info","windows","windows-automation"],"latest_commit_sha":null,"homepage":null,"language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aloth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-06T17:27:45.000Z","updated_at":"2026-03-07T08:14:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/aloth/PowerSkills","commit_stats":null,"previous_names":["aloth/powerskills"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/aloth/PowerSkills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloth%2FPowerSkills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloth%2FPowerSkills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloth%2FPowerSkills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloth%2FPowerSkills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aloth","download_url":"https://codeload.github.com/aloth/PowerSkills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloth%2FPowerSkills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32012787,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agent","ai-tools","automation","browser-automation","cdp","cli","com-automation","desktop-automation","devtools-protocol","edge-browser","json-api","llm-tools","outlook","powershell","powershell-module","powershell-script","system-info","windows","windows-automation"],"created_at":"2026-04-04T09:00:30.367Z","updated_at":"2026-04-19T16:01:03.360Z","avatar_url":"https://github.com/aloth.png","language":"PowerShell","funding_links":[],"categories":["Agent Infrastructure"],"sub_categories":["Agent Skills \u0026 Tools"],"readme":"# PowerSkills\n\n[![License: MIT](https://img.shields.io/github/license/aloth/PowerSkills)](https://github.com/aloth/PowerSkills/blob/main/LICENSE)\n[![Release](https://img.shields.io/github/v/release/aloth/PowerSkills)](https://github.com/aloth/PowerSkills/releases)\n[![PowerShell 5.1+](https://img.shields.io/badge/PowerShell-5.1%2B-blue?logo=powershell\u0026logoColor=white)](https://docs.microsoft.com/en-us/powershell/)\n[![Windows](https://img.shields.io/badge/Windows-10%2F11-0078D6?logo=windows\u0026logoColor=white)](https://github.com/aloth/PowerSkills)\n[![Stars](https://img.shields.io/github/stars/aloth/PowerSkills)](https://github.com/aloth/PowerSkills/stargazers)\n[![AgentSkills](https://img.shields.io/badge/AgentSkills-compatible-blue)](https://agentskills.io)\n\n![PowerSkills Hero](assets/powerskills-ai-agents-windows-powershell-automation.jpg)\n\nWindows capabilities for AI agents — Outlook, Edge browser, desktop automation, and shell commands as structured JSON skills.\n\n## Installation\n\n```\ngit clone https://github.com/aloth/PowerSkills\n```\n\nEach skill has a `SKILL.md` for self-discovery. No dependencies required.\n\n### For AI agents (via AgentSkills)\n\n```bash\nnpx skills add aloth/PowerSkills\n```\n\n## Quick Start\n\n```powershell\n# List available skills\n.\\powerskills.ps1 list\n\n# Get skill help\n.\\powerskills.ps1 outlook help\n\n# Run actions\n.\\powerskills.ps1 outlook inbox --limit 10\n.\\powerskills.ps1 browser tabs\n.\\powerskills.ps1 desktop screenshot --out-file screen.png\n.\\powerskills.ps1 system exec --command \"whoami\"\n```\n\n## Skills\n\n| Skill | Description |\n|-------|-------------|\n| `outlook` | Email \u0026 calendar via Outlook COM |\n| `browser` | Edge automation via CDP (Chrome DevTools Protocol) |\n| `desktop` | Screenshots, window management, keystrokes |\n| `system` | Shell commands, processes, system info |\n\n## Output Format\n\nAll commands return JSON with consistent envelope:\n\n```json\n{\n  \"status\": \"success\",\n  \"exit_code\": 0,\n  \"data\": { ... },\n  \"timestamp\": \"2026-03-06T16:00:00+01:00\"\n}\n```\n\n## Requirements\n\n- Windows 10/11\n- PowerShell 5.1+\n- Microsoft Outlook (for `outlook` skill)\n- Microsoft Edge with `--remote-debugging-port=9222` (for `browser` skill)\n\n### Execution Policy\n\nIf scripts are blocked (`UnauthorizedAccess` error), set the execution policy:\n\n```powershell\nSet-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned\n```\n\nOr run one-off with bypass:\n\n```powershell\npowershell -ExecutionPolicy Bypass -File .\\powerskills.ps1 list\n```\n\n## Standalone Skills\n\nEach skill can be called directly without `powerskills.ps1`:\n\n```powershell\n.\\skills\\outlook\\outlook.ps1 inbox --limit 5\n.\\skills\\system\\system.ps1 info\n.\\skills\\browser\\browser.ps1 tabs\n```\n\nStandalone mode uses `lib\\bootstrap.ps1` for arg parsing and JSON output.\n\n### Edge CDP Setup\n\n```powershell\n# Start Edge with debugging enabled\nStart-Process \"msedge\" -ArgumentList \"--remote-debugging-port=9222\"\n```\n\n## Configuration\n\nEdit `config.json`:\n\n```json\n{\n  \"edge_debug_port\": 9222,\n  \"default_timeout\": 30,\n  \"outlook_body_max_chars\": 5000,\n  \"output_dir\": \"\"\n}\n```\n\n## For AI Agents\n\nEach skill has a `SKILL.md` with action documentation. Point your agent to `skills/\u003cname\u003e/SKILL.md` for structured capability discovery.\n\n### Agent Integration\n\nAdd to your skills directory or reference directly:\n\n```yaml\n# SKILL.md reference\nskills:\n  - name: powerskills\n    description: Windows automation via PowerShell (Outlook, Edge, desktop)\n    location: /path/to/PowerSkills/\n```\n\n## Project Structure\n\n```\nPowerSkills/\n├── powerskills.ps1          # CLI entry point / dispatcher\n├── config.json              # Configuration\n├── lib/\n│   └── bootstrap.ps1        # Shared arg parsing \u0026 JSON output helpers\n├── assets/\n│   └── powerskills-ai-agents-windows-powershell-automation.jpg\n├── skills/\n│   ├── outlook/\n│   │   ├── SKILL.md         # Agent-readable skill documentation\n│   │   └── outlook.ps1      # Outlook COM automation\n│   ├── browser/\n│   │   ├── SKILL.md\n│   │   └── browser.ps1      # Edge CDP automation\n│   ├── desktop/\n│   │   ├── SKILL.md\n│   │   └── desktop.ps1      # Win32 window/screenshot/clipboard\n│   └── system/\n│       ├── SKILL.md\n│       └── system.ps1       # System info, processes, exec\n├── tests/\n│   └── test-all.ps1         # Test suite (-SkipBrowser, -SkipOutlook)\n├── SKILL.md                 # Root skill metadata\n├── LICENSE                  # MIT\n└── README.md\n```\n\n## Contributing\n\nContributions are welcome! Here's how you can help:\n\n- **Report bugs** - open an [issue](https://github.com/aloth/PowerSkills/issues) with the Bug Report template\n- **Request features** - suggest new actions or skills via [Feature Request](https://github.com/aloth/PowerSkills/issues)\n- **Add a skill** - create a new folder under `skills/` with a `.ps1` and `SKILL.md`\n- **Improve existing skills** - better error handling, new actions, documentation fixes\n- **Join the discussion** - share ideas in [Discussions](https://github.com/aloth/PowerSkills/discussions)\n\nWhen adding or modifying skills, please follow the existing patterns:\n1. Use `lib\\bootstrap.ps1` for arg parsing and JSON output\n2. Return results via `Write-SkillResult` / `Write-SkillError`\n3. Include a `SKILL.md` with action documentation\n4. Test both dispatcher and standalone modes\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faloth%2FPowerSkills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faloth%2FPowerSkills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faloth%2FPowerSkills/lists"}