feat: Add Official Microsoft & Gemini Skills (845+ Total)
🚀 Impact Significantly expands the capabilities of **Antigravity Awesome Skills** by integrating official skill collections from **Microsoft** and **Google Gemini**. This update increases the total skill count to **845+**, making the library even more comprehensive for AI coding assistants. ✨ Key Changes 1. New Official Skills - **Microsoft Skills**: Added a massive collection of official skills from [microsoft/skills](https://github.com/microsoft/skills). - Includes Azure, .NET, Python, TypeScript, and Semantic Kernel skills. - Preserves the original directory structure under `skills/official/microsoft/`. - Includes plugin skills from the `.github/plugins` directory. - **Gemini Skills**: Added official Gemini API development skills under `skills/gemini-api-dev/`. 2. New Scripts & Tooling - **`scripts/sync_microsoft_skills.py`**: A robust synchronization script that: - Clones the official Microsoft repository. - Preserves the original directory heirarchy. - Handles symlinks and plugin locations. - Generates attribution metadata. - **`scripts/tests/inspect_microsoft_repo.py`**: Debug tool to inspect the remote repository structure. - **`scripts/tests/test_comprehensive_coverage.py`**: Verification script to ensure 100% of skills are captured during sync. 3. Core Improvements - **`scripts/generate_index.py`**: Enhanced frontmatter parsing to safely handle unquoted values containing `@` symbols and commas (fixing issues with some Microsoft skill descriptions). - **`package.json`**: Added `sync:microsoft` and `sync:all-official` scripts for easy maintenance. 4. Documentation - Updated `README.md` to reflect the new skill counts (845+) and added Microsoft/Gemini to the provider list. - Updated `CATALOG.md` and `skills_index.json` with the new skills. 🧪 Verification - Ran `scripts/tests/test_comprehensive_coverage.py` to verify all Microsoft skills are detected. - Validated `generate_index.py` fixes by successfully indexing the new skills.
This commit is contained in:
77
skills/official/microsoft/plugins/wiki-onboarding/SKILL.md
Normal file
77
skills/official/microsoft/plugins/wiki-onboarding/SKILL.md
Normal file
@@ -0,0 +1,77 @@
|
||||
---
|
||||
name: wiki-onboarding
|
||||
description: Generates two complementary onboarding guides — a Principal-Level architectural deep-dive and a Zero-to-Hero contributor walkthrough. Use when the user wants onboarding documentation for a codebase.
|
||||
---
|
||||
|
||||
# Wiki Onboarding Guide Generator
|
||||
|
||||
Generate two complementary onboarding documents that together give any engineer — from newcomer to principal — a complete understanding of a codebase.
|
||||
|
||||
## When to Activate
|
||||
|
||||
- User asks for onboarding docs or getting-started guides
|
||||
- User runs `/deep-wiki:onboard` command
|
||||
- User wants to help new team members understand a codebase
|
||||
|
||||
## Language Detection
|
||||
|
||||
Scan the repository for build files to determine the primary language for code examples:
|
||||
- `package.json` / `tsconfig.json` → TypeScript/JavaScript
|
||||
- `*.csproj` / `*.sln` → C# / .NET
|
||||
- `Cargo.toml` → Rust
|
||||
- `pyproject.toml` / `setup.py` / `requirements.txt` → Python
|
||||
- `go.mod` → Go
|
||||
- `pom.xml` / `build.gradle` → Java
|
||||
|
||||
## Guide 1: Principal-Level Onboarding
|
||||
|
||||
**Audience**: Senior/staff+ engineers who need the "why" behind decisions.
|
||||
|
||||
### Required Sections
|
||||
|
||||
1. **System Philosophy & Design Principles** — What invariants does the system maintain? What were the key design choices and why?
|
||||
2. **Architecture Overview** — Component map with Mermaid diagram. What owns what, communication patterns.
|
||||
3. **Key Abstractions & Interfaces** — The load-bearing abstractions everything depends on
|
||||
4. **Decision Log** — Major architectural decisions with context, alternatives considered, trade-offs
|
||||
5. **Dependency Rationale** — Why each major dependency was chosen, what it replaced
|
||||
6. **Data Flow & State** — How data moves through the system (traced from actual code, not guessed)
|
||||
7. **Failure Modes & Error Handling** — What breaks, how errors propagate, recovery patterns
|
||||
8. **Performance Characteristics** — Bottlenecks, scaling limits, hot paths
|
||||
9. **Security Model** — Auth, authorization, trust boundaries, data sensitivity
|
||||
10. **Testing Strategy** — What's tested, what isn't, testing philosophy
|
||||
11. **Operational Concerns** — Deployment, monitoring, feature flags, configuration
|
||||
12. **Known Technical Debt** — Honest assessment of shortcuts and their risks
|
||||
|
||||
### Rules
|
||||
- Every claim backed by `(file_path:line_number)` citation
|
||||
- Minimum 3 Mermaid diagrams (architecture, data flow, dependency graph)
|
||||
- All Mermaid diagrams use dark-mode colors (see wiki-vitepress skill)
|
||||
- Focus on WHY decisions were made, not just WHAT exists
|
||||
|
||||
## Guide 2: Zero-to-Hero Contributor Guide
|
||||
|
||||
**Audience**: New contributors who need step-by-step practical guidance.
|
||||
|
||||
### Required Sections
|
||||
|
||||
1. **What This Project Does** — 2-3 sentence elevator pitch
|
||||
2. **Prerequisites** — Tools, versions, accounts needed
|
||||
3. **Environment Setup** — Step-by-step with exact commands, expected output at each step
|
||||
4. **Project Structure** — Annotated directory tree (what lives where and why)
|
||||
5. **Your First Task** — End-to-end walkthrough of adding a simple feature
|
||||
6. **Development Workflow** — Branch strategy, commit conventions, PR process
|
||||
7. **Running Tests** — How to run tests, what to test, how to add a test
|
||||
8. **Debugging Guide** — Common issues and how to diagnose them
|
||||
9. **Key Concepts** — Domain-specific terminology explained with code examples
|
||||
10. **Code Patterns** — "If you want to add X, follow this pattern" templates
|
||||
11. **Common Pitfalls** — Mistakes every new contributor makes and how to avoid them
|
||||
12. **Where to Get Help** — Communication channels, documentation, key contacts
|
||||
13. **Glossary** — Terms used in the codebase that aren't obvious
|
||||
14. **Quick Reference Card** — Cheat sheet of most-used commands and patterns
|
||||
|
||||
### Rules
|
||||
- All code examples in the detected primary language
|
||||
- Every command must be copy-pasteable
|
||||
- Include expected output for verification steps
|
||||
- Use Mermaid for workflow diagrams (dark-mode colors)
|
||||
- Ground all claims in actual code — cite `(file_path:line_number)`
|
||||
Reference in New Issue
Block a user