Skip to content

docs(skill): full new-repo onboarding sequence#18

Merged
jcschaff merged 1 commit into
mainfrom
docs/onboarding-sequence
Jul 3, 2026
Merged

docs(skill): full new-repo onboarding sequence#18
jcschaff merged 1 commit into
mainfrom
docs/onboarding-sequence

Conversation

@jcschaff

@jcschaff jcschaff commented Jul 3, 2026

Copy link
Copy Markdown
Member

What

Adds an "Onboarding a new repo (the full sequence)" section to skill/SKILL.md.

Why

bootstrap is easy to mistake for a one-shot repo setup. It's actually only step 1 — a local file scaffold that makes no Zenodo calls, mints no concept, and installs no workflows. This section spells out the whole path so the scaffold isn't mistaken for the finish line:

  1. bootstrap — scaffold CITATION.cff + .zenodo.json (TODO authors, no DOI)
  2. Fill authors → cffconvert sync → add related_identifiers
  3. First archive (or create-concept for a fork) — this is what produces the concept DOI
  4. Paste the concept DOI into CITATION.cff
  5. Install the two reusable workflows + ZENODO_TOKEN secret
  6. Disable the native integration → verify with doctor
  7. (optional) add {repo, concept} to monitored.json

Docs-only.

🤖 Generated with Claude Code

https://claude.ai/code/session_01BZx7w9BexQc9wWU5JoHYaF

Clarify that bootstrap is only step 1 (local file scaffold, no Zenodo calls,
no concept, no workflows) and lay out the whole sequence: scaffold -> fill
authors/sync -> first archive to get the concept DOI -> record it -> install
the reusable workflows + token -> disable native integration and verify with
doctor -> optionally add to monitored.json.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BZx7w9BexQc9wWU5JoHYaF
@jcschaff jcschaff merged commit 6665aff into main Jul 3, 2026
1 check passed
@jcschaff jcschaff deleted the docs/onboarding-sequence branch July 3, 2026 10:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant