nsaspy/gpt-org-roam
1
0
Fork 0
Code Issues Pull requests 4 Projects Releases Packages Wiki Activity Actions

Enforce tutorial naming and add authoring skill #5

Open
lost-rob0t wants to merge 1 commit from agent/tutorial-naming-and-skills into main
pull from: agent/tutorial-naming-and-skills
merge into: nsaspy:main
Conversation 0 Commits 1 Files changed 4 +183 -2
lost-rob0t commented 2026-08-13 06:06:49 +00:00 (Migrated from github.com)
Copy link

What changed

  • rename the StarLang tutorial to tutorials/00-starlang-from-zero.org while preserving its existing blob content and Org-roam ID
  • document the NN-<project>-<slug>.org convention in README.md, with 00-<project>-<slug>.org as the canonical first-tutorial example
  • add skills/tutorial-authoring/SKILL.md for source verification, Org-roam stability, current-vs-planned behavior, tutorial structure, and validation rules
  • extend CI so tutorial filenames must follow the numbered lowercase kebab-case convention

Why

The tutorials repository needs deterministic ordered filenames and a repository-local skill that agents can read before creating or updating learning material. The filename rule is enforced in CI rather than left as a manual convention.

StarLang verification

The StarLang tutorial remains technically current against lost-rob0t/star-lang main commit d2fe099be57a11f8a671e77152e92d92470a76b8. Relevant runtime-migration PRs #17 and #22 are still open, matching the tutorial's current-state warning.

Validation

  • compared branch against main; diff is limited to the intended rename, README, CI workflow, and skill file
  • GitHub CI should validate UTF-8 Org files, titles, unique IDs, resolvable ID links, and the new tutorial filename convention

Merge only when all required checks are green.

## What changed - rename the StarLang tutorial to `tutorials/00-starlang-from-zero.org` while preserving its existing blob content and Org-roam ID - document the `NN-<project>-<slug>.org` convention in `README.md`, with `00-<project>-<slug>.org` as the canonical first-tutorial example - add `skills/tutorial-authoring/SKILL.md` for source verification, Org-roam stability, current-vs-planned behavior, tutorial structure, and validation rules - extend CI so tutorial filenames must follow the numbered lowercase kebab-case convention ## Why The tutorials repository needs deterministic ordered filenames and a repository-local skill that agents can read before creating or updating learning material. The filename rule is enforced in CI rather than left as a manual convention. ## StarLang verification The StarLang tutorial remains technically current against `lost-rob0t/star-lang` main commit `d2fe099be57a11f8a671e77152e92d92470a76b8`. Relevant runtime-migration PRs #17 and #22 are still open, matching the tutorial's current-state warning. ## Validation - compared branch against `main`; diff is limited to the intended rename, README, CI workflow, and skill file - GitHub CI should validate UTF-8 Org files, titles, unique IDs, resolvable ID links, and the new tutorial filename convention Merge only when all required checks are green.
nsaspy changed title from WIP: Enforce tutorial naming and add authoring skill to Enforce tutorial naming and add authoring skill 2026-08-27 19:42:15 +00:00
This pull request has changes conflicting with the target branch.
  • .github/workflows/ci.yml
  • README.md
View command line instructions

Manual merge helper

Use this merge commit message when completing the merge manually.

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin agent/tutorial-naming-and-skills:agent/tutorial-naming-and-skills
git switch agent/tutorial-naming-and-skills

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main
git merge --no-ff agent/tutorial-naming-and-skills
git switch agent/tutorial-naming-and-skills
git rebase main
git switch main
git merge --ff-only agent/tutorial-naming-and-skills
git switch agent/tutorial-naming-and-skills
git rebase main
git switch main
git merge --no-ff agent/tutorial-naming-and-skills
git switch main
git merge --squash agent/tutorial-naming-and-skills
git switch main
git merge --ff-only agent/tutorial-naming-and-skills
git switch main
git merge agent/tutorial-naming-and-skills
git push origin main
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
bug
Something isn't working

  
documentation
Improvements or additions to documentation

  
duplicate
This issue or pull request already exists

  
enhancement
New feature or request

  
good first issue
Good for newcomers

  
help wanted
Extra attention is needed

  
invalid
This doesn't seem right

  
question
Further information is requested

  
wontfix
This will not be worked on

No labels
bug
documentation
duplicate
enhancement
good first issue
help wanted
invalid
question
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
nsaspy/gpt-org-roam!5
No description provided.