Skip to content

feat(skills) add Hypit to the Skill Hub catalog - #658

Open
QuanCheng-QC wants to merge 1 commit into
developfrom
feature/skill-catalog-hypit
Open

feat(skills) add Hypit to the Skill Hub catalog#658
QuanCheng-QC wants to merge 1 commit into
developfrom
feature/skill-catalog-hypit

Conversation

@QuanCheng-QC

Copy link
Copy Markdown
Collaborator

What

Adds Hypit to the Skill Hub catalog. Hypit is a video authoring toolkit for AI agents,
distributed as an Agent Skill rather than as an agent of its own, so it enters through the
catalog and not the agent registry. The entry points at hypit-ai/hypit, path skills/hypit.

Why that path only works now

The skill used to live at .agents/skills/hypit. _assertSafeSourcePath requires every
segment of a source_path to begin with [A-Za-z0-9], so a dot-prefixed path is rejected
outright and the skill could not be addressed at all. Hypit has since moved it to a dot-free
repository source, which lets us fetch it unchanged.

Four places carry a catalog skill

File Change
workspace/backend/app/skill_catalog.py the entry the installer resolves through find_skill
workspace/frontend/components/skills/skills-view.tsx the Skill Hub grid keeps its own list
workspace/frontend/lib/i18n/messages/{en-US,zh-CN}.ts the skills.catalog.hypit description

packages/agent-connector/src/skill-catalog.js is the workspace module catalog and is
unrelated — third-party skills do not go there.

Category

ai-ml, following the closest precedent in the file: SenseNova Image Gen is also a generation
skill and is filed there. A category of its own is worth doing once more Hypit skills land; one
entry does not justify a filter tab with a single card in it.

Verification

Installed through the real Skill Hub UI on two platforms, using this exact entry.

Linux. The install lands 56 files in <workingDir>/.claude/skills/hypit,
listInstalledSkills reports it, and uninstall leaves the directory clean — checked for both
claude and codex agent types. A Claude agent then discovered the skill on its own, followed
its environment gate, selected a Distribution, established a project boundary, wrote a runtime
profile and drove the real Hypit CLI. It stopped at credential resolution, which is a Hypit
platform limit rather than an integration failure: packages/credential-store-os throws on
anything that is not darwin or win32, and Hypit's own environment.md lists only macOS 13+ and
Windows 10/11 as supported hosts.

Windows. Same install path, then the step Linux could not reach — HypiHub OAuth completed
and the credential was written to the OS credential store, FFmpeg 9.0.1 went on PATH, and
hypit runtime up began provisioning. The chain works end to end on a supported host.

The backend catalog loads with 67 entries and unique ids; the frontend typechecks
(tsc --noEmit, exit 0).

Merge timing

hypit-ai/hypit is still private and the installer clones over anonymous HTTPS, so an install
fails today for anyone whose git has no read access to it. Hypit expects to open the repository
within days. Until then this entry only works where such access is configured, so it is worth
holding the merge until the repository is public rather than shipping a catalog card that cannot
install.

Follow-ups found while testing

Not fixed here — separate PRs. All are in the install path and all are reproducible:

  1. installSkill fetches with execFileSync, freezing the entire daemon event loop for the
    length of the clone (15s in one run). Every other adapter's poll and heartbeat then dies with
    socket hang up at the moment the loop resumes.
  2. git clone --sparse fails on older git, which reports cannot change to '<url>' and
    installs nothing. A --no-checkout + sparse-checkout + checkout sequence gives an
    identical result at the same speed and works on every version.
  3. installSkill clears its destination with readdir + rmSync, both of which follow symlinks,
    so installing into a repository that symlink-shares its skills directory deletes the real
    source files.
  4. Unrelated failures collapse into one line. A mirror rewrite conflict, an old git, a reset
    connection and a missing git on the daemon's PATH all surface as could not fetch skill,
    with git's own stderr swallowed. The health probe has the same shape of problem: a silently
    retried auth failure is reported as "may be waiting for interactive input".
  5. Claude's check_ready.creds_file disagrees across the three registry sources #631 now has a live reproduction. A working Windows agent is reported as Not logged in
    because check_ready.creds_file points at ~/.claude/sessions, which is session bookkeeping
    rather than credentials.

Hypit is a video authoring toolkit for AI agents, distributed as an Agent Skill
rather than as an agent of its own, so it enters through the Skill Hub catalog and
not the agent registry.

The entry points at hypit-ai/hypit, path skills/hypit. That path only became
addressable this week. The skill used to live under .agents/skills/hypit, and the
installer refuses a source path whose segments begin with a dot, so it could not be
referenced at all. Hypit has moved it to a dot-free repository source, which lets
OpenAgents fetch it unchanged.

Four places carry a catalog skill, all updated here
  - the backend catalog, which the installer reads
  - the Skill Hub grid in the frontend, which keeps its own list
  - the English and Simplified Chinese description catalogues

Category is ai-ml, following the closest precedent in the file. SenseNova Image Gen
is also a generation skill and is filed there. A category of its own is worth doing
once more Hypit skills land; one entry does not justify its own filter tab.

Verified by installing this exact entry with the connector's own installer, for both
claude and codex. Each install lands 56 files, listInstalledSkills reports the skill,
and uninstall leaves the directory empty. The frontend typechecks.

One caveat worth recording. The hypit repository is still private and the installer
clones over anonymous https, so an install fails today for anyone whose git has no
read access to it. Hypit expects to open the repository within days; until then the
entry works only where such access is configured.
@vercel

vercel Bot commented Sep 4, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
openagents-workspace Ready Ready Preview Sep 4, 2026 11:47am UTC

Request Review

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