Navigation hub for all guides in this repository. Browse by category below.
Fundamental setup, conventions, and troubleshooting for working with skills in this repository.
| Guide | Description |
|---|---|
| Getting Started | What skills are, how to install them, Copilot CLI usage |
| Contributing | Skill folder layout, frontmatter, description writing, body guidelines, PR process |
| Skill Testing | Eval creation, fixtures, regression loops, trigger and description optimization |
| Troubleshooting | Setup fixes for install, activation, and proxy issues |
Core practices for designing, testing, and deploying agent workflows with Copilot.
| Guide | Description |
|---|---|
| Agent Design Best Practices | Core principles, file structure, context management, tool guidance, examples, and stopping conditions for .agent.md files |
| Responsible Agent Use | Not burning your Copilot token budget — context, models, agent mode, MCP, plugins, skills, and a must-do checklist |
| Agent Testing | Eval creation and body quality testing for .agent.md files — agents are invoked by @-mention, not auto-triggered |
CLI-based agents and dashboards for terminal-driven coding and cost tracking.
| Guide | Description |
|---|---|
| Tools Overview | Catalog of CLI-based AI coding agents and agentic development tools |
| Pi Coding Agent | Minimal BYOK terminal agent -- quickstart, extensions, troubleshooting |
| GitHub Copilot CLI | Multi-model agentic terminal agent with native GitHub integration |
| CodeBurn | Token usage, cost, and performance dashboard for 25+ AI coding tools |
Orchestrated agent workflows that coordinate multiple skills for complex tasks.
| Guide | Description |
|---|---|
| Living Doc BDD Copilot | Living documentation and BDD automation — catalog management (User Stories, Features, Functionalities, AC updates, impact analysis, gap finding) and automation (webapp exploration, PageObjects, Gherkin, step definitions, maintenance) |
Task-specific guidance for using individual skills. Start by picking your use case below.
| Guide | Description |
|---|---|
| Token Saving | Keeping AI responses concise — how the token-saving skill works and when it applies |
| PR Review | How the PR review skill works, what sections it applies, and how to trigger it |
| Create Repository | Creating a new AbsaOSS/absa-group repo from the template with standard guardrails |
| Guide | Description |
|---|---|
| Accessibility Infra Setup | Bootstrap Playwright + axe-core a11y infrastructure in an Angular app (WCAG 2.2 AA) — config, shared fixture, one example scan, npm scripts, docs |
| TDD Workflow | Test-driven development with: specification, confirmation gates, and vertical-sliced implementation |
| Unit Test Standards | Reference for unit test standards across isolation, scope, naming, assertions, coverage, fixtures |
| Unit Test Writer | Generate complete unit tests from scratch following language-specific standards |
| Unit Test Reviewer | Systematically audit unit tests and report findings by severity |
| Test Data Management | How the test-data-management skill works, what it covers, and when it fires |
| Test Mocking Patterns | Double selection, patching strategies, cleanup, and language-specific guidance |
Start here: @living-doc-bdd-copilot — orchestrates the full workflow.
| Guide | Description |
|---|---|
| Create User Story | Author well-formed User Stories with business-level ACs ready for E2E scenarios |
| Create Feature | Document system surfaces (UI screens, APIs, services) as Feature entities |
| Create Functionality | Define atomic, testable behaviors with Acceptance Criteria for unit/integration tests |
| Update Living Doc | Amend entities: add ACs, change status, deprecate, update ownership and links |
| Guide | Description |
|---|---|
| Gherkin Step Definitions | Multi-language step definition patterns: Python behave, TypeScript/Java Cucumber, Scala; state sharing, hooks, parameter types |
| Scenario Creator | Convert User Story and Functionality ACs to Gherkin scenarios with full traceability tagging |
| Gherkin ↔ Living Doc Sync | Keep scenarios and ACs in sync: audit AC links, fix drift, propagate changes |
| PageObject Scan | Discover, create, and maintain Playwright PageObjects: bootstrap, re-scan after UI changes, heal selector drift |
| Data-Cy Instrument | Add missing test-id attributes to templates; sync PageObjects to use getByTestId() |
| Guide | Description |
|---|---|
| BDD Maintenance | Clean up BDD artifacts: remove deprecated feature files, find dead code, audit unused steps and PageObject methods |
| Gap Finder | Audit living doc completeness: find undocumented features, orphan tests, untested ACs; produce gap reports |
| Impact Analysis | Trace PR impact on living doc: identify affected Features, Functionalities, User Stories; determine what to review/re-test |
Keep this index up to date. When you add a new guide, add a row to the appropriate table above.
See also the main README for the skill catalog, scope, and FAQ.