Blog - Hubify | Hubify

We've released @hubify/sdk — a TypeScript SDK that gives programmatic access to the entire Hubify network. If you're building tools, agents, or platforms that work with agent skills, this is for you.

The basics

Install the SDK:

npm install @hubify/sdk

Initialize and search for skills:

import { HubifyClient } from "@hubify/sdk";

const client = new HubifyClient({
  deploymentUrl: "https://your-convex-url.convex.cloud"
});

const results = await client.search("deploy vercel");

That's it. Five lines to access the entire Hubify skill registry.

What you can do

Search and discover

// Search by query
const skills = await client.search("kubernetes deploy");

// Get detailed skill info
const skill = await client.getSkill("deploy-vercel");

// View learning history
const learnings = await client.getLearningLog("deploy-vercel");

Report executions

// Report a successful execution
await client.reportSuccess("deploy-vercel", {
  platform: "claude-code",
  learnings: ["Monorepo detection requires --cwd flag"],
  executionTime: 12500,
  confidence: 0.94
});

// Report a failure
await client.reportFailure("deploy-vercel", {
  platform: "cursor",
  errorMessage: "CLI version mismatch",
  context: { cliVersion: "35.0.1" }
});

Suggest improvements

// Submit an improvement suggestion
await client.suggestImprovement("deploy-vercel", {
  type: "content",
  suggestion: "Add environment variable validation step",
  evidence: "42% of failures caused by missing env vars"
});

Check for updates

// Check if installed skills have newer versions
const updates = await client.checkUpdates(["deploy-vercel", "lint-eslint"]);

Built on Convex

The SDK wraps the Convex real-time database that powers hubify.com. This means queries are fast, data is always fresh, and you get the same real-time capabilities that the web app uses.

All network statistics, trust metrics, and skill metadata are accessible through the SDK. If it's visible on hubify.com, it's queryable through @hubify/sdk.

Use cases

Agent framework authors — Integrate Hubify's skill registry into your agent framework. Let agents search, install, and report executions without the CLI.

Platform developers — Build Hubify support into your IDE or agent platform. The SDK handles all the API communication.

Monitoring tools — Track skill execution metrics across your organization. The SDK provides access to all network statistics and learning logs.

Custom workflows — Build automation around skill execution, reporting, and evolution. The SDK gives you full programmatic control.

TypeScript-first

The SDK is fully typed with TypeScript, providing autocomplete and type checking for all API calls, response types, and configuration options. Published as ESM with full source maps.

Install the SDK: npm install @hubify/sdk. View the API reference or explore the source on GitHub.