🔧 VS Code Agent Skills

State-of-the-art Agent Skills for GitHub Copilot in VS Code. Supercharge your debugging, code optimization, and development workflow.

⚡ Quick Install

curl -fsSL https://raw.githubusercontent.com/g97iulio1609/vscode-agent-skills/main/install.sh | bash

🎯 Available Skills

🔍 advanced-debugging

Hypothesis-driven debugging with automatic instrumentation, git worktrees, and log analysis.

🔧 tech-debt-reducer

Technical debt reduction with complexity analysis, unused code detection, code smell detection, and refactoring patterns.

🧬 skill-generator

Meta-skill for creating new skills from discovered patterns.

🎼 oneplan

Marketing-friendly, GitHub-native Context-Driven Engineering: milestones (tracks), issues (spec/plan), sub-issues (phases/tasks), parallelism and resumable execution.

📋 Commands

Agent	Commands
Debug	@debug hypotheses, @debug instrument, @debug cleanup, @debug worktree
Tech Debt	@techdebt assess, @techdebt complexity, @techdebt smells, @techdebt unused
OnePlan	@oneplan setup, @oneplan track, @oneplan plan, @oneplan implement, @oneplan status, @oneplan sync

🧩 Editors

This repository ships a VS Code extension. Editors that support VS Code extensions (for example Cursor, depending on version and policy) can typically install the .vsix and use the same commands/settings.

✅ Recommended workflow automation

If you want the "post-track tech debt" step to happen automatically on GitHub, you can add the workflow template:

• templates/oneplan/workflows/oneplan-techdebt-on-milestone-closed.yml

It creates a Tech Debt review issue whenever a milestone is closed.

🔧 Requirements

• VS Code (or a VS Code-compatible editor) with Copilot Chat enabled
• VS Code setting: chat.useAgentSkills: true
• Git, Node.js 18+
• (Recommended for OnePlan GitHub automation) GitHub CLI: gh + gh auth login

GitHub terms & policies (must-read)

OnePlan and the related VS Code commands can create/read/update GitHub Issues, Milestones and Labels (via GitHub CLI / API). When you use these features you are responsible for complying with GitHub terms and policies, including:

• GitHub Terms of Service: https://docs.github.com/en/site-policy/github-terms/github-terms-of-service
• GitHub Acceptable Use Policies: https://docs.github.com/en/site-policy/acceptable-use-policies/github-acceptable-use-policies
• GitHub Privacy Statement: https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement

This repository is not affiliated with GitHub. This is not legal advice.

📄 License

MIT