How jyoung706/skillhub works
SkillHub is a self-hosted, governed registry for reusable agent skills. Users publish versioned packages into team or global namespaces; others discover authorized skills through search and install/manage them with the CLI or integrations. The graph also preserves review/governance, suites, authentication, storage, web UI, and GitHub synchronization as distinct capabilities. Relationships are limited to README-documented workflows and source-index/excerpt evidence; several controllers and integration details are unsampled, so their internal call paths are not asserted.
Main entry points: controller API Controllers · SkillQueryService.java Skill Lifecycle · index.ts SkillHub CLI · pool.go Sync Worker
Components 21
User Experience
- SkillHub CLI
cli/src/index.ts - Web Portal
web/src/main.tsx - Agent Plugin
plugins/dsh/src/host/index.ts
Registry and Governance
- API Controllers
server/skillhub-app/src/main/java/com/iflytek/skillhub/controller - Skill Lifecycle
server/skillhub-domain/src/main/java/com/iflytek/skillhub/domain/skill/service/SkillQueryService.java - Namespace Governance
server/skillhub-domain/src/main/java/com/iflytek/skillhub/domain/namespace - Review Governance
server/skillhub-domain/src/main/java/com/iflytek/skillhub/domain/review/ReviewService.java - Accounts and Tokens
server/skillhub-auth/src/main/java/com/iflytek/skillhub/auth - Skill Records
server/skillhub-domain/src/main/java/com/iflytek/skillhub/domain/skill/Skill.java - Namespace Records
server/skillhub-domain/src/main/java/com/iflytek/skillhub/domain/namespace/Namespace.java - Review Tasks
server/skillhub-domain/src/main/java/com/iflytek/skillhub/domain/review/ReviewTask.java
Discovery and Bundles
- Full Text Search
server/skillhub-search/src/main/java/com/iflytek/skillhub/search/postgres/PostgresFullTextQueryService.java - Skill Suites
server/skillhub-domain/src/main/java/com/iflytek/skillhub/domain/suite/SkillSuiteQueryService.java - Bundle Operations
server/skillhub-app/src/main/java/com/iflytek/skillhub/service/bundle/SkillSuiteBundleOperationQueryService.java
Platform Services
- Package Storage
server/skillhub-storage/src/main/java/com/iflytek/skillhub/storage/ObjectStorageService.java - S3 Storage
server/skillhub-storage/src/main/java/com/iflytek/skillhub/storage/S3StorageService.java
GitHub Synchronization
- Sync Worker
github-sync-go/internal/worker/pool.go - GitHub Client
github-sync-go/internal/github/client.go - Sync Endpoints
server/skillhub-app/src/main/java/com/iflytek/skillhub/controller/GithubSyncInternalController.java
Other components
- Registry User
- GitHub
Connections 22
- Registry User → SkillHub CLI: uses
README.md - Registry User → Web Portal: uses
README.md - SkillHub CLI → API Controllers: calls REST API
README.md - Web Portal → API Controllers: uses platform
- API Controllers → Skill Lifecycle: routes skill actions
- API Controllers → Namespace Governance: routes namespace actions
- API Controllers → Accounts and Tokens: routes authentication
- Skill Lifecycle → Skill Records: reads and updates
server/skillhub-domain/src/main/java/com/iflytek/skillhub/domain/skill/service/SkillQueryService.java - Namespace Governance → Namespace Records: reads namespace
server/skillhub-app/src/main/java/com/iflytek/skillhub/service/NamespacePortalQueryAppService.java - Skill Lifecycle → Namespace Records: checks access
server/skillhub-domain/src/main/java/com/iflytek/skillhub/domain/skill/service/SkillQueryService.java - Review Governance → Review Tasks: manages tasks
server/skillhub-domain/src/main/java/com/iflytek/skillhub/domain/review/ReviewService.java - Registry User → Full Text Search: discovers skills
README.md - Full Text Search → Skill Records: filters visibility
server/skillhub-search/src/main/java/com/iflytek/skillhub/search/postgres/PostgresFullTextQueryService.java - Registry User → Skill Suites: uses suites
README.md - Registry User → Bundle Operations: views operations
- SkillHub CLI → Skill Lifecycle: installs skills
README.md - Skill Lifecycle → Package Storage: stores packages
server/skillhub-domain/src/main/java/com/iflytek/skillhub/domain/skill/service/SkillQueryService.java - S3 Storage → Package Storage: implements
server/skillhub-storage/src/main/java/com/iflytek/skillhub/storage/S3StorageService.java - Agent Plugin → API Controllers: connects to registry
- Sync Worker → GitHub Client: requests repositories
- Sync Worker → Sync Endpoints: syncs with
- GitHub Client → GitHub: reads repositories