Skip to content

docs(brand): align repo words with the curated registry position - #128

Open
harlan-zw wants to merge 4 commits into
mainfrom
brand/wording
Open

docs(brand): align repo words with the curated registry position#128
harlan-zw wants to merge 4 commits into
mainfrom
brand/wording

Conversation

@harlan-zw

Copy link
Copy Markdown
Collaborator

❓ Type of change

  • 📖 Documentation
  • 🧹 Chore

📚 Description

The GitHub description, README, npm page, and CLI help still described skilld as a generator or a flat list of verbs, while the product is a curated registry of Skills with a human author. This is Workstream 1 of the rebrand plan: the words only.

README leads with the tagline, run-first usage, four proof points, and a demoted "Author a Skill" section. New SECURITY.md says how to report a problem and what a source status does and does not claim. GLOSSARY gains registry, provenance, curated, author, lockfile. npm gets the new description, keywords, and homepage. Clap about lines for install, view, update, verify, auth, config follow appendix B. "Verified Skill X." becomes "Verified the source of Skill X." and the TLS error drops the word secure. The protocol README stops leading with v2 nouns and says Node 22.

Example selector is now skilld:skilld-dev/skills/find-skill in README and clap, since find-skill exists in skilld-dev/skills and vue does not. The /vs/skills-sh URL in the README ships later on the site.

Open question: the README claims skilld.dev lists a Skill under its author's name. Author pages exist but bylines on cards are Workstream 4; if that reads as overclaiming, cut the clause.

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

https://claude.ai/code/session_018T67Ndp8FAjnHWthXABbJW

Front doors still read as a v1 generator or a flat verb list. This lands the
Workstream 1 wording: npm metadata and homepage, README rewrite with tagline,
proof points, and Author a Skill, SECURITY.md, glossary terms for registry,
provenance, curated, author, and lockfile, clap about lines, the TLS error
wording, the protocol README, and one real example selector everywhere.

Claude-Session: https://claude.ai/code/session_018T67Ndp8FAjnHWthXABbJW
@harlan-github-agent harlan-github-agent Bot added harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. labels Sep 1, 2026
@harlan-github-agent

harlan-github-agent Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

🤖 BLOCKED

Harlan Agent Kit posted this automated review. It is not Harlan's personal review or approval. AI open source policy. A person still decides the merge.

  • Merge gate: Passed.

  • Review gate: BLOCKED. The documented Get Started search step never returns the example Skill, so users following README and migration docs hit a dead end before the run step.

  • CI gate: Passed.

  • Open: The documented Get Started search step never returns the example Skill, so users following README and migration docs hit a dead end before the run step.. Next: The controller cannot write this pull request branch.

  • Open: The supporting-file example names references/api.md, a file find-skill does not carry, so the documented command fails with SOURCE_NOT_FOUND.. Next: Point the example at a file find-skill actually carries (e.g. agents/openai.yaml), or use the local-path form already used in clap help (skilld run ./skills/my-skill --file references/api.md, crates/skilld-command/src/lib.rs:109).

  • Open: The comparison line links to a page that does not exist yet, so the merged README ships a dead link.. Next: Land the /vs/skills-sh page before merging, or drop the comparison line and reintroduce it with the site workstream.

@harlan-github-agent harlan-github-agent Bot added harlan-agent-blocked The automated Review found a material defect in this head commit. and removed harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. labels Sep 1, 2026
The migration guide kept run and install examples for a vue Skill that
skilld-dev/skills does not publish. Use find-skill, which the README
already names.

Claude-Session: https://claude.ai/code/session_018T67Ndp8FAjnHWthXABbJW
@harlan-github-agent harlan-github-agent Bot added harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-blocked The automated Review found a material defect in this head commit. and removed harlan-agent-blocked The automated Review found a material defect in this head commit. harlan-agent-running An Agent holds a Task on this issue or pull request right now. labels Sep 1, 2026
Header, badges, tagline quote, Features, and What is skilld? now follow
the shape of mdream, ripast, and gscdump. Commands use placeholders and
a Selectors note explains the skilld:OWNER/REPOSITORY/SKILL form.

Claude-Session: https://claude.ai/code/session_018T67Ndp8FAjnHWthXABbJW
@harlan-github-agent harlan-github-agent Bot added harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-blocked The automated Review found a material defect in this head commit. and removed harlan-agent-blocked The automated Review found a material defect in this head commit. harlan-agent-running An Agent holds a Task on this issue or pull request right now. labels Sep 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

harlan-agent-blocked The automated Review found a material defect in this head commit.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant