Skip to content
Back to skills

Fixtures

ASecurity

docs(quickstart): add 5-minute getting-started guide

  • 3,953 stars
  • 0 votes
  • 0 copies
  • 2 views
  • Added September 2, 2026
ai-agentsgit

Works with

  • cli

Security analysis

A100/100

Pro scans all 7 files and shows the line behind each finding

Scanned September 2, 2026

npx -y skills add microsoft/apm --skill fixtures --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Fixtures?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Fixtures
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/microsoft-fixtures-43888cad/badge)](https://www.skillsdirectory.com/skills/microsoft-fixtures-43888cad)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
docs(quickstart): add 5-minute getting-started guide

## TL;DR

New contributors land on the docs index, scroll, and bounce.
This PR adds a 5-minute quickstart linked from the landing page
so first-touch users have a happy path before reading reference
material.

## Problem (WHY)

- Issue #640 reports a 60% bounce rate on `/docs/` for new
  visitors.
- The current landing page lists every guide in alphabetical
  order; "Quickstart" did not exist.
- Agent Skills makes the diagnosis explicit:
  ["agents pattern-match well against concrete structures"](https://agentskills.io/skill-creation/best-practices)
  -- and the same is true for human readers landing cold.

## Approach (WHAT)

Additive: see Implementation. One new page, one link added on
the index.

## Implementation (HOW)

| File | Change |
|---|---|
| `docs/src/content/docs/guides/quickstart.md` | NEW. 5-minute happy path: install, init, run. |
| `docs/src/content/docs/index.md` | Promote quickstart link above the alphabetical guide list. |

## Trade-offs

- **Promoting one guide above the list**: minor visual
  asymmetry; pays for itself if bounce rate drops.
- **Rejected**: rewriting the landing page. Higher risk, larger
  diff, harder to A/B.

## Benefits

1. Closes #640 if bounce rate drops measurably.
2. New contributor first-touch falls under 5 minutes.
3. Zero code change; rollback is `git revert`.

## Validation

```
$ npm run --prefix docs build
built in 4.2s
no broken links
$ apm audit --ci
0 findings
```

## How to test

- [ ] `npm run --prefix docs dev`
- [ ] Open `http://localhost:4321/docs/`; confirm Quickstart
      link is above the fold.
- [ ] Click through; confirm the 5 steps complete on a fresh
      clone in under 5 minutes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Files in this skill

  • auth-refactor__with_skill.md3.7 KB
  • auth-refactor__without_skill.md1009 B
  • dep-bump__with_skill.md1.4 KB
  • dep-bump__without_skill.md246 B
  • docs-only__with_skill.md1.8 KB
  • docs-only__without_skill.md264 B

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…