docs(readme): update documentation to reflect Agent Skills structure

- Add separate sections for Agent Skills and Custom Instructions
- Document dynamic loading benefits (~70% token reduction)
- Update project structure to include skills, instructions, and prompts
- Add links to all Agent Skills with descriptions
- Clarify distinction between dynamic skills and always-active instructions
- Include references to skills README and migration guide

Author: devbyray

README.md

@@ -15,7 +15,8 @@ Use this starter to define, manage, and share custom instructions and prompts fo
 -   [Features](#features)
 -   [Project Structure](#project-structure)
 -   [Getting Started](#getting-started)
--   [Custom Instructions & Guidelines](#custom-instructions--guidelines)
+-   [Agent Skills (Dynamic Loading)](#agent-skills-dynamic-loading)
+-   [Custom Instructions (Always Active)](#custom-instructions-always-active)
 -   [Custom Prompts](#custom-prompts)
 -   [Specification-Driven Workflow Prompt (Optional)](#specification-driven-workflow-prompt-optional)
 -   [Contributing](#contributing)
@@ -28,13 +29,17 @@ GitHub Copilot Starter is a template repository for configuring, customizing, an
 
 ## Features
 
+-   **Agent Skills**: Modular, dynamically-loaded skills following the [Agent Skills specification](https://agentskills.io/specification) for ~70% reduction in baseline token usage
+-   **Custom instructions**: Universal principles (security, accessibility, best practices) that apply to all code
 -   **Flexible instruction system**: Easily add, edit, or remove instruction files for coding standards, workflows, UI guidelines, accessibility, testing, and more
 -   **Customizable prompts**: Define your own Copilot prompts and conventions for your team or project
 -   **Best practices templates**: Includes example instructions for SOLID, DRY, KISS, commit messages, accessibility, and more
 -   **Specification-driven workflow**: Optionally use the included workflow for requirements, design, implementation, and validation
 -   **No fixed tech stack**: Adapt to any language, framework, or toolchain
 
-## Project Structure
+## Project Stskills/` — Agent Skills (dynamically loaded when relevant)
+-   `.github/instructions/` — Custom instructions (always active, universal principles)
+-   `.github/prompts/` — Custom prompts for specific workflows
 
 -   `.github/instructions/` — Core instruction files (edit or add your own)
 -   `/src`, `/tests`, `/public`, `/config`, `/docs` — Example folders for typical projects (customize or remove as needed)
@@ -44,32 +49,54 @@ GitHub Copilot Starter is a template repository for configuring, customizing, an
 1. **Clone the repository**
     ```zsh
     git clone https://github.com/devbyrayray/github-copilot-starter.git
-    cd github-copilot-starter
-    ```
-2. **Review and customize instruction files**
-    - Edit files in `.github/instructions/` to match your team's standards and workflow
-    - Add new instruction files for additional rules or prompts
+    cd github-copilot-starskills and instructions**
+    - Browse Agent Skills in `.github/skills/` for language/framework-specific standards
+    - Edit custom instructions in `.github/instructions/` for universal principles
+    - Customize prompts in `.github/prompts/` for specific workflows
 3. **Integrate with your project**
-    - Copy or merge the instructions into your own repository
+    - Copy or merge the skills, instructions, and prompts into your own repository
     - Adjust folder structure as needed for your tech stack
-
-## Custom Instructions & Guidelines
-
--   All coding standards, workflows, and conventions are defined in `.github/instructions/`
--   Example instructions provided for:
-    -   Coding standards ([coding.instructions.md](.github/instructions/coding.instructions.md))
-    -   Accessibility ([accessibility.instructions.md](.github/instructions/accessibility.instructions.md))
-    -   CSS ([css.instructions.md](.github/instructions/css.instructions.md))
-    -   Tailwind CSS ([tailwind.instructions.md](.github/instructions/tailwind.instructions.md))
-    -   HTML ([html.instructions.md](.github/instructions/html.instructions.md))
-    -   UI guidelines ([ui-guidelines.instructions.md](.github/instructions/ui-guidelines.instructions.md))
-    -   Commit messages ([commit.instructions.md](.github/instructions/commit.instructions.md))
-    -   Best practices ([best-practices.instructions.md](.github/instructions/best-practices.instructions.md))
-    -   Configuration files ([config.instructions.md](.github/instructions/config.instructions.md))
-    -   C# standards ([csharp.instructions.md](.github/instructions/csharp.instructions.md))
-    -   .NET standards ([dotnet.instructions.md](.github/instructions/dotnet.instructions.md))
-    -   JavaScript/TypeScript standards ([javascript-typescript.instructions.md](.github/instructions/javascript-typescript.instructions.md))
-    -   Vue standards ([vue.instructions.md](.github/instructions/vue.instructions.md))
+4. Agent Skills (Dynamic Loading)
+
+Agent Skills are modular, discoverable instructions that AI agents load dynamically based on the task at hand. Skills are located in `.github/skills/` and follow the [Agent Skills specification](https://agentskills.io/specification).
+
+**Language & Framework Standards:**
+-   [JavaScript/TypeScript Standards](.github/skills/javascript-typescript-standards/) - ES2022, Node.js, async/await patterns
+-   [Vue.js Development](.github/skills/vue-development/) - Vue 3 Composition API, SFC patterns
+-   [Nuxt.js Development](.github/skills/nuxt-development/) - Nuxt 3, SSR/SSG, file-based routing
+-   [CSS Standards](.github/skills/css-standards/) - CSS organization, selectors, responsive design
+-   [Tailwind CSS](.github/skills/tailwind-css/) - Tailwind v4+, @theme directive, utility classes
+-   [HTML Standards](.github/skills/html-standards/) - Semantic markup, accessibility, security
+-   [C# Standards](.github/skills/csharp-standards/) - C# naming conventions, modern features
+-   [.NET Development](.github/skills/dotnet-development/) - .NET architecture, dependency injection
+-   [Markdown Standards](.github/skills/markdown-standards/) - Documentation formatting, validation
+
+**Workflow Skills:**
+-   [Testing & TDD](.github/skills/testing-tdd/) - TDD methodology, Vitest, xUnit
+-   [Commit Conventions](.github/skills/commit-conventions/) - Conventional Commits + validation script
+
+**Benefits:**
+-   🚀 ~70% reduction in baseline token usage
+-   📦 Progressive disclosure (metadata → instructions → resources)
+-   🔍 Better discovery through rich descriptions
+-   🛠️ Support for executable scripts (e.g., commit validation)
+
+[📖 Learn more about Agent Skills](.github/skills/README.md)
+
+## Custom Instructions (Always Active)
+
+Universal principles and guidelines that apply to all code are located in `.github/instructions/`:
+
+-   [Coding Standards](.github/instructions/coding.instructions.md) - General coding conventions
+-   [Best Practices](.github/instructions/best-practices.instructions.md) - SOLID, DRY, KISS principles
+-   [Security](.github/instructions/security.instructions.md) - OWASP Top 10 security patterns
+-   [Accessibility](.github/instructions/accessibility.instructions.md) - Universal accessibility guidelines
+-   [UI Guidelines](.github/instructions/ui-guidelines.instructions.md) - Design principles
+-   [Configuration](.github/instructions/config.instructions.md) - Configuration file standards
+-   [Project Structure](.github/instructions/project-file-structure.instructions.md) - Repository organization
+-   [Tooling](.github/instructions/tools.instructions.md) - Development tools and workflows
+
+These instructions remain as custom instructions because they contain universal architecture patterns that should always be considered.
     -   Nuxt.js standards ([nuxt.instructions.md](.github/instructions/nuxt.instructions.md))
     -   Markdown standards ([markdown.instructions.md](.github/instructions/markdown.instructions.md))
     -   Project structure ([project-file-structure.instructions.md](.github/instructions/project-file-structure.instructions.md))