Skip to content

feat: sync the skilld Skill from skilld-dev/skilld - #521

Merged
harlan-zw merged 2 commits into
mainfrom
feat/declare-skilld-skill
Oct 7, 2026
Merged

harlan-zw merged 2 commits into
mainfrom
feat/declare-skilld-skill

Conversation

@harlan-zw

Copy link
Copy Markdown
Collaborator

🔗 Linked issue

Related to skilld-dev/skilld#213

❓ Type of change

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

📚 Description

The skilld Skill should have one source of truth, with every other copy synced from it. skills/skilld in skilld-dev/skilld is that source. This repository now declares the Skill with skilld itself:

Architecture after this change: skilld sync fetches the skilld Skill's verified Artifact at a pinned skilld-dev/skilld commit and writes the .skills/skilld copy that Agent links load, CI runs check:skills, and /trending now redirects to /skills/trending

  • .skills/skilld.json pins skilld-dev/skilld/skills/skilld at commit fe3c82cf.
  • pnpm sync:skills runs skilld sync. It writes the verified copy to .skills/skilld, records it in .skills/skilld-lock.yaml, and links it for Claude Code (.claude/skills), Codex (.agents/skills), and opencode (.opencode/skills). Every path stays in the repository, so a fresh clone needs no install step.
  • The new declared-skills CI job runs pnpm check:skills. It fails when someone edits the copy by hand or changes the declaration without a sync.
  • To update the Skill, change the pinned commit and run pnpm sync:skills.
  • Both scripts run skilld@3.6.0 through pnpm dlx, which keeps the lockfile out of this change.

The opencode evals in skilld-dev/skilld#213 found that an Agent without the Skill guesses skilld.dev/trending, which answered 404. It now answers 301 to /skills/trending.

AGENTS.md records the sync rule and where the evals live.

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

skills/skilld in skilld-dev/skilld is the source of truth for the skilld
Skill. This repository now declares it in .skills/skilld.json at a pinned
commit, and skilld sync writes the verified copy to .skills/skilld with
links for Claude Code, Codex, and opencode. CI fails when the copy drifts.

The opencode evals found that an Agent without the Skill guesses
skilld.dev/trending, which answered 404. It now redirects to the board.
@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
skilld sync writes .skills, including a lockfile in its own YAML style. CI checks that directory with check:skills, so ESLint skips it.
@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 caed62c 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