{"id":51150265,"url":"https://github.com/zebbern/vscode_template","last_synced_at":"2026-06-26T05:30:51.111Z","repository":{"id":343342151,"uuid":"1126390487","full_name":"zebbern/vscode_template","owner":"zebbern","description":"Portable VS Code template for AI-assisted development with Claude models - featuring custom agents, MCP servers, prompt files, and Agent Skills","archived":false,"fork":false,"pushed_at":"2026-01-07T04:22:57.000Z","size":38,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-26T04:31:43.821Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zebbern.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-01T20:12:32.000Z","updated_at":"2026-01-22T04:10:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zebbern/vscode_template","commit_stats":null,"previous_names":["zebbern/vscode_template"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zebbern/vscode_template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fvscode_template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fvscode_template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fvscode_template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fvscode_template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zebbern","download_url":"https://codeload.github.com/zebbern/vscode_template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fvscode_template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34805072,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-26T02:00:06.560Z","response_time":106,"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":[],"created_at":"2026-06-26T05:30:49.803Z","updated_at":"2026-06-26T05:30:51.088Z","avatar_url":"https://github.com/zebbern.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# VS Code + Claude Skills Template\n\nA portable template workspace for VS Code with Claude models, featuring skills, custom agents, MCP integration, and prompt files for consistent AI-assisted development.\n\n---\n\n## 🚀 Setup Guide\n\n### Prerequisites\n\n- **Node.js 18+** - Required for MCP servers (`node --version`)\n- **VS Code 1.107+** - Download from [code.visualstudio.com](https://code.visualstudio.com/)\n- **VS Code Insiders** - Required for Agent Skills (preview feature)\n- **GitHub Copilot** - Subscription with Claude Opus 4.5 model access\n- **GitHub Personal Access Token** - Create at [github.com/settings/tokens](https://github.com/settings/tokens)\n\n### Step 1: Copy Template Files\n\n```bash\n# Copy to your project\ncp -r .github/ your-project/.github/\ncp -r .vscode/ your-project/.vscode/\ncp AGENTS.md your-project/\n```\n\n### Step 2: Install MCP Server Dependencies\n\n```bash\n# Pre-install MCP servers for faster startup (optional but recommended)\nnpm install -g @upstash/context7-mcp@latest\nnpm install -g @modelcontextprotocol/server-github\nnpm install -g @modelcontextprotocol/server-filesystem\nnpm install -g @playwright/mcp@latest\nnpm install -g @modelcontextprotocol/server-sequential-thinking\nnpm install -g @modelcontextprotocol/server-memory\n```\n\n### Step 3: Configure GitHub Token\n\n1. Create a token at [github.com/settings/tokens](https://github.com/settings/tokens)\n2. Select scopes: `repo`, `read:user`, `read:org`\n3. VS Code will prompt for the token on first MCP server start\n\n### Step 4: Open in VS Code \u0026 Verify\n\n1. Open your project in VS Code\n2. Open Chat (`Ctrl+Alt+I` / `Cmd+Alt+I`)\n3. Click the **Tools** icon and verify MCP servers are listed\n4. Send this initialization message:\n\n```\nI'm starting a new session. Please confirm you understand:\n1. You have access to custom agents: @plan, @implement, @debug, @code-reviewer\n2. Skills are loaded from .github/skills/ when relevant\n3. MCP servers are available: context7, github, filesystem, playwright, sequentialThinking, memory\n4. Follow the coding guidelines in .github/copilot-instructions.md\n5. Use TDD, create plans before implementation, verify before claiming completion\n\nBriefly confirm your understanding and list available tools.\n```\n\n---\n\n## Features\n\n### Custom Agents\n\n| Agent            | Purpose                      | When to Use                             |\n| ---------------- | ---------------------------- | --------------------------------------- |\n| `@plan`          | Read-only planning           | Creating implementation plans, research |\n| `@implement`     | Full implementation with TDD | Writing code, executing plans           |\n| `@debug`         | Systematic debugging         | Investigating bugs, test failures       |\n| `@code-reviewer` | Code quality review          | Reviewing completed work                |\n\n### Prompt Commands\n\n| Command         | Description                         |\n| --------------- | ----------------------------------- |\n| `/brainstorm`   | Start collaborative design session  |\n| `/write-plan`   | Create detailed implementation plan |\n| `/execute-plan` | Execute an existing plan with TDD   |\n| `/code-review`  | Request thorough code review        |\n| `/debug`        | Start systematic debugging          |\n| `/test`         | Create tests using TDD              |\n\n### Agent Skills\n\nSkills are automatically loaded when relevant:\n\n- **brainstorming**: Explore requirements before implementation\n- **writing-plans**: Create bite-sized task plans\n- **executing-plans**: Follow plans with verification\n- **test-driven-development**: Red-Green-Refactor cycle\n- **systematic-debugging**: Root cause analysis\n- **verification-before-completion**: Evidence before claims\n- **subagent-driven-development**: Parallel task execution with reviews\n\n### Conditional Instructions\n\nLanguage-specific guidelines applied automatically:\n\n- `**/*.py` → Python best practices\n- `**/*.ts` → TypeScript guidelines\n- `**/*.js` → JavaScript standards\n- `**/test*/**` → Testing practices\n\n### MCP Servers\n\nPre-configured high-impact MCP servers:\n\n| Server                  | Purpose               | Key Capabilities                        |\n| ----------------------- | --------------------- | --------------------------------------- |\n| **Context7**            | Library docs          | Real-time documentation for any library |\n| **GitHub**              | Repository management | Issues, PRs, branches, code search      |\n| **Filesystem**          | File operations       | Read/write files, directory trees       |\n| **Playwright**          | Browser automation    | Testing, screenshots, web scraping      |\n| **Sequential Thinking** | Enhanced reasoning    | Step-by-step problem solving            |\n| **Memory**              | Persistent memory     | Knowledge graph across sessions         |\n\nAdditional tools available via VS Code extensions:\n\n- **Pylance MCP** - Python analysis and refactoring\n- **Terminal Tools** - Named terminals, command management\n- **Microsoft Docs** - Azure/Microsoft documentation\n\n## File Structure\n\n```\n.github/\n├── copilot-instructions.md    # Base coding guidelines (always applied)\n├── agents/                     # Custom agents\n│   ├── plan.agent.md\n│   ├── implement.agent.md\n│   ├── debug.agent.md\n│   └── code-reviewer.agent.md\n├── skills/                     # Agent Skills (auto-loaded)\n│   ├── brainstorming/SKILL.md\n│   ├── writing-plans/SKILL.md\n│   ├── executing-plans/SKILL.md\n│   ├── test-driven-development/SKILL.md\n│   └── ...\n├── prompts/                    # Reusable prompts\n│   ├── brainstorm.prompt.md\n│   ├── write-plan.prompt.md\n│   ├── execute-plan.prompt.md\n│   └── ...\n└── instructions/               # Conditional instructions\n    ├── python.instructions.md\n    ├── typescript.instructions.md\n    └── ...\n.vscode/\n├── settings.json              # VS Code configuration\n└── mcp.json                   # MCP server configuration\nAGENTS.md                      # Cross-agent compatibility\n```\n\n## Development Workflow\n\n### For New Features\n\n1. **Brainstorm** → `/brainstorm` or `@plan`\n   - Explore requirements\n   - Design before coding\n\n2. **Plan** → `/write-plan`\n   - Create detailed implementation plan\n   - Save to `docs/plans/`\n\n3. **Execute** → `/execute-plan` or `@implement`\n   - Follow plan with TDD\n   - Commit after each task\n\n4. **Review** → `/code-review` or `@code-reviewer`\n   - Verify quality and plan alignment\n\n### For Bug Fixes\n\n1. **Debug** → `/debug` or `@debug`\n   - Systematic root cause analysis\n   - NO fixes without understanding\n\n2. **Test** → Create regression test\n   - Write test that demonstrates bug\n   - Verify it fails\n\n3. **Fix** → Minimal fix to pass test\n   - TDD Red-Green-Refactor\n\n4. **Verify** → Run all tests\n   - Ensure no regressions\n\n## Customization\n\n### Add Language-Specific Instructions\n\nCreate `.github/instructions/\u003clanguage\u003e.instructions.md`:\n\n```markdown\n---\napplyTo: \"**/*.\u003cext\u003e\"\ndescription: Language-specific guidelines\n---\n\n# Your Guidelines Here\n```\n\n### Add Custom Prompts\n\nCreate `.github/prompts/\u003cname\u003e.prompt.md`:\n\n```markdown\n---\nname: my-prompt\ndescription: What this prompt does\nagent: plan # or implement, debug, code-reviewer\ntools: [\"search\", \"fetch\"]\n---\n\n# Prompt Instructions\n```\n\n### Add MCP Servers\n\nEdit `.vscode/mcp.json` to add new servers.\n\n## Requirements\n\n| Requirement      | Version | Notes                               |\n| ---------------- | ------- | ----------------------------------- |\n| Node.js          | 18+     | Required for MCP servers            |\n| VS Code          | 1.107+  | Custom agents, MCP support          |\n| VS Code Insiders | Latest  | Required for Agent Skills (preview) |\n| GitHub Copilot   | Active  | With Claude Opus 4.5 model access   |\n\n## Research Sources\n\nThis template follows the latest 2025 best practices from:\n\n- [VS Code Copilot Customization](https://code.visualstudio.com/docs/copilot/customization/overview)\n- [Agent Skills Standard](https://agentskills.io/) - Open standard for portable skills\n- [Custom Agents](https://code.visualstudio.com/docs/copilot/customization/custom-agents)\n- [GitHub Copilot Instructions](https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot)\n- [awesome-copilot](https://github.com/github/awesome-copilot) - Community examples\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzebbern%2Fvscode_template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzebbern%2Fvscode_template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzebbern%2Fvscode_template/lists"}