developer-quickstart-guide skill (samber): write or audit a developer quickstart
Writes or audits a developer quickstart that gets a reader to one verified success, with copy-paste steps and expected output.
- Installs
- 12.7K
- on skills.sh
- Stars
- 7
- on GitHub
- Files
- 5
- besides SKILL.md
- Updated
- Nov 2026
- last repo commit
developer-quickstart-guide makes your agent pick one visible success moment, set a time budget and write a page where every step has a heading, one copy-paste block, the expected output and a one-line fail branch. For an existing page it cold-runs it first and lists defects before rewriting.
It triggers on a quickstart, getting-started page, hello-world doc or "time to first success", or on "our setup is too hard". The folder holds SKILL.md and four reference files and bundles no scripts. The cold run needs a clean environment, which you or the agent provides.
Good for
- Teams shipping an SDK or API who need the getting-started page
- Docs owners whose readers do not finish their getting-started page
- Developer experience leads who want a measured time to first success
Install developer-quickstart-guide
Claude Code
- 1
Copy this prompt.
Install the developer-quickstart-guide skill in Claude Code. Run this command: /plugin marketplace add samber/developer-relations-skills /plugin install developer-relations-skills@developer-relations-skills Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
The README recommends installing the whole collection because its skills reference each other, and developer-quickstart-guide names other skills in the collection to hand work to. The whole-collection routes add all 93 skills in the repo (counted from the git tree); the repo holds no hooks, agents, commands or MCP server files, and 14 of its skills bundle a script. Pick one route per agent.
From the project README. Source.
What's in the skill
When it loads
Writes or audits a developer quickstart that carries a reader from zero to one verified success - minimal path, copy-paste commands, expected output at every step, fail branches, and a cold-run time budget. Use whenever the user mentions a quickstart, a getting-started page, a hello-world doc, "time to first success" or "time to first value", onboarding docs for an API, SDK, CLI or self-hosted tool, or complains nobody finishes their getting-started page - even if they only say "our setup is too hard". Do NOT use for a teaching tutorial (samber/developer-relations-skills@developer-tutorial) or a README rewrite (samber/developer-relations-skills@readme-optimization).
Sections in SKILL.md
- Who the reader is
- Scope check
- Interview
- Workflow
- Time budget
- Invocation examples
- Copy-paste rules
- Pass threshold
- Friction log
- KPIs
- Ownership
- Failure modes
- Reader-type split
- References
Key facts
- Author
- Samuel Berthe (samber)
- Installs on skills.sh
- 12,695 (as of Nov 2, 2026)
- GitHub stars
- 8 for the whole collection repo (Nov 2, 2026)
- Last commit
- Nov 1, 2026 (whole repo)
- skills.sh audits
- Gen Agent Trust Hub pass, Socket pass, Snyk pass
- Version in SKILL.md
- 1.0.2
- Collection size
- 93 skills in the repo (counted from the git tree)
What it includes
Asks up to twelve questions one at a time until the success moment and budget are clear.
Question 8 asks whether you can run the steps yourself on a clean machine or need a verification plan someone else executes.
InterviewChooses greenfield or audit; an audit cold-runs the existing page first.
SKILL.md says never rewrite from reading alone.
Runs code ·
Set the modeNames the product visibly working and sets a baseline time budget per product class.
The table covers seven classes from a 5-minute hosted API to a 30 to 60 minute self-hosted service. SKILL.md labels the per-class budgets as its own baseline.
Pick the success moment and time budgetCuts setup the reader does not need and lists the rest before step 1.
The ranking runs from no account at all down to a sales-gated sandbox.
Delete prerequisites, then list what survivesGives each step a heading, one copy-paste block, expected output and a fail branch.
Commands and output sit in separate blocks and placeholders look unmistakable.
Write each stepShips only when five checks pass on a clean environment with a fresh account.
Every command works as written, real output matches, no prerequisite appears after step 1, time is inside budget, and a newcomer reaches success without leaving the page.
Runs code ·
Verify by cold runLogs every hesitation during the run and defines step-level drop-off as the first metric.
It also suggests running the quickstart commands in CI against the published package.
Friction log and KPIsReturns six parts, from success moment and budget to a verification plan.
It never emits a page without the budget and the verification plan.
Try: “We're launching a Go SDK next week, write the quickstart.”
Output
From the official docs
Permissions
Low risk
The agent can run your quickstart commands on a clean environment, so use a test account and read each command before it runs.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
The cold run executes your quickstart commands
SKILL.md wants a clean environment and a fresh account with no cached credentials. Our advice: use a test account, never real credentials, and read each command before it runs. github.com
It may keep notes in devrel-context.md
SKILL.md tells the agent to store a few details about the current task or project, and to use a file called devrel-context.md when its memory lives in a file. Our advice: open that file before you commit or share the folder. github.com
The plugin route installs the whole collection
The README's plugin and extension routes add every skill in the repo; its git tree holds 93. The repo has no hooks, agents, commands or MCP server files, and 14 of its skills bundle a script. Our advice: use the skills CLI command for this skill if you want only it. github.com
Security advisories
No published security advisories as of Nov 2, 2026.
Technical details
| Turning on read-only | SKILL.md describes no read-only mode. |
|---|---|
| Scopes |
|
Questions
How do I install developer-quickstart-guide?
The README says to install every skill in the collection, because its skills reference each other. In Claude Code that is the plugin route in the install box above, which adds all 93 skills in the repo. The skills CLI can add just this one. Our advice: pick one route per agent.
What do I get at the end?
A quickstart page plus a stated success moment and time budget, a cut list, a verification plan and instrumentation notes. For an audit it leads with a defect table. SKILL.md says an unverified page with no stated budget is a draft, not a deliverable.
developer-quickstart-guide vs developer-tutorial?
Use this skill for a fast path to one success and developer-tutorial for teaching a concept step by step. SKILL.md says not to use it for a teaching tutorial, and the README describes the other skill as writing or auditing a teaching tutorial.
Is it the same as a README rewrite?
It is not. SKILL.md routes a README rewrite to readme-optimization, which the README describes as auditing and rewriting a repository README.
Does the agent run my quickstart?
It can, if it has command access. SKILL.md wants a cold run on a clean environment with a fresh account and no cached credentials, and offers a verification plan someone else runs when the agent cannot execute commands.
Does developer-quickstart-guide need an API key, and where does it work?
SKILL.md names no API key, account or environment variable. The README documents installs for Claude Code, Claude.ai (add the repo as a plugin marketplace), Codex, Cursor, Gemini CLI and any Agent Skills-compatible tool through the skills CLI. The install box has the steps for each.
Is developer-quickstart-guide safe to install?
It is instructions plus four reference files, and the folder bundles no scripts. In an audit the agent can run your quickstart commands on a clean environment. Our advice: use a throwaway directory or container and a test account, and read each command before it runs.
Information
updated Nov 2, 2026
- Repository
- samber/developer-relations-skills
- Folder
skills/developer-quickstart-guide
Sources
Docs, issue trackers and discussions this page is built from.
Show all 2Hide
- developer-relations-skills README · github.com
- developer-quickstart-guide SKILL.md · github.com