Skip to content

feat(remote): read linked files from GitHub at the attested commit - #209

Merged
harlan-zw merged 1 commit into
mainfrom
feat/linked-files
Oct 7, 2026
Merged

harlan-zw merged 1 commit into
mainfrom
feat/linked-files

Conversation

@harlan-zw

@harlan-zw harlan-zw commented Oct 6, 2026 •

Copy link
Copy Markdown
Collaborator

🔗 Linked issue

Related to skilld-dev/skilld.dev#510, which lists linked files. Its ADR-0013 has the design.

❓ Type of change

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

📚 Description

skilld downloads an Artifact of at most 64 MiB. A larger Skill ran without the files that did not fit. thvroyal/kimi-skills/kimi-xlsx lost its 73 MiB binary that way.

skilld now sends skilld-capabilities: linked-files on each Resolution request. skilld.dev then lists the files that do not fit as linkedFiles in the signed statement, each with its path, mode, size and Git blob SHA. After the Artifact verifies, skilld reads each linked file from raw.githubusercontent.com at the attested commit. It installs the Skill only when every file has its attested size and blob SHA. The installed digest covers the linked files too.

Linked files hold 256 MiB at most, and they count against the 2,000 file limit. A statement with nothing linked has no linkedFiles field, so it reads the same in released versions. skilld.dev never sends the field to a client that does not ask for it.

Architecture: skilld asks skilld.dev for linked files, verifies the Artifact, then reads each linked file from raw.githubusercontent.com

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

skilld.dev can now sign Skills larger than the 64 MiB Artifact. It lists
the largest files as linked files, by path, mode, size and Git blob SHA,
and only for a client that asks. skilld asks on every Resolution, reads
each linked file from raw.githubusercontent.com at the attested commit,
and installs the Skill only when every one matches its blob SHA. The
installed digest covers the linked files too.
@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 Oct 6, 2026
@harlan-github-agent

harlan-github-agent Bot commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

🤖 MERGED

Harlan Agent Kit posted this automated review. It is not Harlan's personal review or approval. AI open source policy. Last updated: 2026-10-07 01:20 UTC.

GitHub merged this pull request.

No material findings were recorded.

The pull request closed.

@harlan-github-agent harlan-github-agent Bot added harlan-agent-running An Agent holds a Task on this issue or pull request right now. 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 Oct 6, 2026
@harlan-zw
harlan-zw merged commit 1bea736 into main Oct 7, 2026
3 checks passed
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