# 🔧 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

```bash
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