Skip to content
Back to skills

Fixtures

ASecurity

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

  • 3,953 stars
  • 0 votes
  • 0 copies
  • 3 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…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.