Skip to content

feat(demos): add a shipreel demo shown on its Skill page only - #536

Merged
harlan-zw merged 2 commits into
mainfrom
feat/demo-skill-page-only
Oct 7, 2026
Merged

harlan-zw merged 2 commits into
mainfrom
feat/demo-skill-page-only

Conversation

@harlan-zw

Copy link
Copy Markdown
Collaborator

🔗 Linked issue

No linked issue.

❓ Type of change

  • 📖 Documentation
  • 🐞 Bug fix
  • 👌 Enhancement
  • ✨ New feature
  • 🧹 Chore
  • ⚠️ Breaking change

📚 Description

Some demos should show on their Skill page and nowhere else. Until now every demo also landed on the /skills/demos board, the homepage section, its own demo page, and the demos sitemap. The thebstar/shipreel demo is the first one kept to its Skill page.

Skill page only demos

  • A manifest entry with skillPageOnly: true stays out of listShownSkillDemos. The board, the homepage, and the sitemap leave it out, and its demo page answers 404. It does not count toward the six demos the board needs to be indexable.
  • The Skill page still shows it. The Demo panel hides "All demos" for it, as it does for a flagged Skill.
  • The schema refuses a pin on such a demo, because a pin orders the homepage.
  • pnpm demo:record ... --skill-page-only sets the flag. A re-record keeps it.
  • GLOSSARY.md (demo placement) and COPY.md (Demo panel) describe it.

The shipreel demo

shipreel turns a pull request into a narrated walkthrough video. The seed folder held Mossgrove, a small fictional booking API, with an idempotency-key change on a branch. shipreel defaults to macOS say, so the seed's shipreel.yml names a local Piper voice and a 60 second target. The demo's setup line says so.

The Agent made a 63 second film in four chapters, with narration, captions, diagrams, and code panels. The 720p web copy is 1.4 MB on media.skilld.dev.

🤖 AI disclosure: Harlan Agent Kit modified this description. My AI open-source policy.

Some demos suit their Skill page but not the /skills/demos board, the
homepage, or a demo page of their own. A skillPageOnly entry keeps the
demo on its Skill page alone, and the recorder sets it with
--skill-page-only.
@harlan-zw harlan-zw added the harlan-agent-review Pull request triage requires an adversarial Review. Adding this label manually always forces one. label Oct 7, 2026
@harlan-github-agent harlan-github-agent Bot added harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. and removed harlan-agent-review Pull request triage requires an adversarial Review. Adding this label manually always forces one. labels Oct 7, 2026
…only

# Conflicts:
#	scripts/record-skill-demo.ts
@harlan-zw harlan-zw added the harlan-agent-review Pull request triage requires an adversarial Review. Adding this label manually always forces one. label Oct 7, 2026
@harlan-github-agent harlan-github-agent Bot removed the harlan-agent-review Pull request triage requires an adversarial Review. Adding this label manually always forces one. label Oct 7, 2026
@harlan-zw
harlan-zw merged commit 111c62c into main Oct 7, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant