Skip to content
Skills Library
Programming · Building & coding

scaffold

/scaffold

Set up a new project so build, lint, typecheck, and test all run from day one. Use when a calibrated idea is confirmed and there is no project yet, or when an existing project has no working checks. Only invoke via the orcinus router.

Licence
MIT
Last repository change
11.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 11.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Set up a new project so build, lint, typecheck, and test all run from day one. Use when a calibrated idea is confirmed and there is no project yet, or when an existing project has no working checks. Only invoke via the orcinus router.

Original author description

Set up a new project so build, lint, typecheck, and test all run from day one. Use when a calibrated idea is confirmed and there is no project yet, or when an existing project has no working checks. Only invoke via the orcinus router.

How it works

  1. Rules
  2. Steps, in order
  3. What scaffold is not
  4. Sources
Original SKILL.md headings · 74 lines, 659 words
SKILL.md preview
---
name: scaffold
description: Set up a new project so build, lint, typecheck, and test all run from day one. Use when a calibrated idea is confirmed and there is no project yet, or when an existing project has no working checks. Only invoke via the orcinus router.
license: MIT
user-invocable: false
---

# SCAFFOLD — a project that is green from day one

Create the smallest project that builds, lints, typechecks, and tests. Do not write the real feature here. Do not commit a red project. The first commit happens only after all four commands pass.

## Rules

- No scaffold before a calibrated brief. If idea-calibrate has not confirmed the problem, user, success criteria, non-goals, and first slice, stop and run it first.
- Do not choose a stack silently. Confirm it with the user in one round, with a recommended answer, and record the choice and why.
- Every file must earn its place. No file without a stated need.
- No real secrets, ever. Placeholders only, in `.env.example`. Never commit a secret, and never ask for one in chat.
- The four commands are the gate. If any fails, fix only the cause and re-run all four.

## Steps, in order

### 1. Confirm the brief and the stack

Read the calibrated brief. Confirm the first slice. Then ask the user to confirm the stack (language, test runner, linter). Record the answer. If the user has no preference, recommend TypeScript with `tsc` and Node's built-in test runner, and say why: no extra test framework to install, and the four commands stay simple.

### 2. Create the tree

Create only these, unless the stack needs one more file — and if so, name the need:

- `README.md` — what the project is, in one paragraph, plus how to run the four commands.
- `package.json` (or the stack's manifest) — with scripts named exactly `build`, `lint`, `typecheck`, `test`.
- `src/` — with one minimal module for the first slice (a stub that does nothing yet, but compiles).
- `tests/` — with one passing test for that stub.
- `docs/constitution.md` — three to five invariants the project will enforce (see step 3).
- `.gitignore` — `node_modules/`, `dist/`, `.env`, and the stack's build output.
- `.env.example` — placeholder names only, no real values.
- `LICENSE` — MIT unless the user says otherwise.

### 3. Write the constitution

In `docs/constitution.md`, write the invariants in plain language, for example:

- No test weakening. Never delete, weaken, or skip a test to make the suite pass.
- One slice at a time. One behaviour, one test, one commit.
- No secrets in the repo.
- Implementer is never the final judge; orcinus-verify checks the work.

These are rules, not wishes. Later work must be able to point at them.

### 4. Secrets and environment

Put placeholder names in `.env.example` only. Put `.env` in `.gitignore` and never commit it. If a service needs a real key, the user provides it on their own machine. Human-only steps (accounts, keys, provisioning) belong to the user, never to the agent.

### 5. Initialise git

`git init -b main`. Do not commit yet.

### 6. Verify — all four, in order

Run, and record the real output and exit code for each:

1. `build`
2. `lint`
3. `typecheck`
4. `test`

All four must pass on the empty project with its one passing test. If any fails, fix only the cause and re-run all four from the top. Do not skip a failing check and do not weaken the test to get a pass.

### 7. First commit

Only now, commit with a clear message. Record in the handoff: what was built, the four commands and their outputs, the stack choice and why, and what the first real slice will be.

## What scaffold is not

Not the feature. Not a stack choice made for the user. Not a place to hide a failing check. If the four commands cannot all pass, the scaffold is not done.

## Sources

Method, in our own words, inspired by: spec-kit (github/spec-kit, MIT) for the spec and constitution pattern; create-mercato-app (MIT) for the scaffolding pattern; repomix (MIT) for the codebase map, which comes after scaffolding, not during it. No text was copied from those projects.

Versions

RepositoryScoreLicence
This page · DnsQueen/orcinus-skills100MIT
jeremylongshore/tons-of-skills-marketplace100MIT
optimiziramsi/skills100MIT
jkaloger/lazyspec100MIT
genkovich/sdlc100MIT
duc01226/EasyPlatform100MIT
duc01226/EasyPlatform100MIT
chuckplayer/claude-agent-pack100MIT
dan323/easier-life-skills100MIT

Database snapshot: 13.11.2026 · package version 90a02aea92be (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100gate
    (forwward) Runs lint, typecheck, build, and test in a self-healing loop that reads errors, fixes them, and retries up to 4 times. Triggers on verify, check, make sure it works, pre-commit validation, pre-deploy checks, or any quality gate.
  • 100wire-ci
    Add continuous integration and a local quality gate to a TypeScript project. Use when the user says "set up CI", "add a GitHub Actions workflow", "wire up the typecheck/lint/test gate", "add pre-commit checks", "add secret scanning", or asks how to keep the build green…
  • 100build-check
    Run the project's objective quality gates — typecheck, lint, tests, and a production build, whatever this project actually uses — then diagnose any failure down to the file and root cause. Use before committing, opening a PR, or declaring work done, and whenever asked whether…
  • 100build-check
    Run the project's objective quality gates — typecheck, lint, tests, and a production build, whatever this project actually uses — then diagnose any failure down to the file and root cause. Use before committing, opening a PR, or declaring work done, and whenever asked whether…
  • 100running-checks
    Apply when about to run pnpm typecheck, lint, lint:fix, test, build, coverage or bench in any package, or format from the root, when deciding which checks a change owes before its push, and whenever you find yourself waiting on a check's output. Esposter's split between the…
  • 95stacks
    Start a new project from a stack or add fragments to an existing repo, then drive it to a verified working state. Use for project setup, tests, lint, CI and agent configuration, or when the user mentions stacks.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.