Hosted onhoraciodev.dev.hyper.mediavia theHypermedia Protocol

Installing Seed Skills for AI AgentsA guide to installing Seed Hypermedia skills for Claude Code and other AI agents, covering both the universal installer and the Claude Code marketplace.

Seed Hypermedia provides agent skills that let AI assistants create, read, update, and search documents on the Seed protocol. This guide covers two installation methods, each with different trade-offs.

Method 1: Universal Installer (npx skills)

The universal installer works with any AI agent that supports skills -- Claude Code, Cursor, Cline, Codex, and more. Run the following command in your terminal:

npx skills add seed-hypermedia/skills

The installer clones the skill repository and presents the available skills for selection:

Skills installer showing available seed skillsSkills installer showing available seed skills

Select seed-cli (recommended starting point) and any other skills you need using the space bar:

Selecting seed-cli skill for installationSelecting seed-cli skill for installation

The installer shows a summary with security risk assessments, the installation path, and which agents the skill will be available to:

Installation summary with security assessmentsInstallation summary with security assessments

Confirm the installation. The skill is now available in your agent. In Claude Code, you can invoke it with /seed-cli.

Trade-offs

  • Works with 40+ AI agents (Claude Code, Cursor, Cline, Codex, and more)

  • Installed locally as a symlink -- you control when to update

  • No automatic updates: to get the latest version, re-run npx skills add seed-hypermedia/skills

Method 2: Claude Code Marketplace

If you use Claude Code exclusively, you can install skills through the built-in marketplace. This method provides automatic daily updates.

Open the plugin manager in Claude Code with /plugin, navigate to the Marketplaces tab, and select + Add Marketplace:

Claude Code marketplace tabClaude Code marketplace tab

Enter the marketplace source seed-hypermedia/skills:

Adding the seed-hypermedia marketplaceAdding the seed-hypermedia marketplace

Then install the plugin with /plugin install seed-hypermedia@seed-hypermedia-skills and reload with /reload-plugins.

Trade-offs

  • Claude Code only -- does not work with other agents

  • Automatic daily updates: skill improvements are picked up without manual action

  • Managed through the Claude Code plugin system

After Installation

Once installed, the skills appear as slash commands. Type /seed to see all available Seed skills:

Available seed skills in Claude CodeAvailable seed skills in Claude Code

The main skills are:

  • /seed-cli -- Create, update, read, and search Seed documents. No local setup needed -- connects to remote servers.

  • /seed-grpc -- Low-level gRPC access to a local Seed daemon for advanced operations.

  • /seed-pdf-import -- Import PDF documents into Seed using AI-powered content recognition.

Start by asking your AI agent to create a document: _"write a document about X and publish it to Seed"_. The agent handles key management, content formatting, and publishing automatically.

Working with Seed Skills

Once the skill is installed, you interact with it through natural language. You don't need to learn the underlying CLI commands -- the agent reads the skill instructions and translates your intent into the right operations. Behind the scenes, the skill uses seed-cli, a command-line tool that handles searching, reading, creating, and updating documents. Here are some of the operations your agent can perform on your behalf:

# Search for documents across a Seed server
seed-cli search "server rendering" --type hybrid --limit 5

# Read a document by its hypermedia URL
seed-cli document get hm://z6Mk.../tech-talks/server-specs

# List your signing keys
seed-cli key list

# Save a draft before publishing (the agent does this automatically)
seed-cli draft create -f content.md

# Publish a document under your account
seed-cli document create -f content.md --key mykey -p my-document

The most common workflows are document creation, search, and updates. When creating documents, the agent follows a draft-first approach: it writes the content to a local draft file, validates it, and shows you the result before publishing anything. This means you always get a chance to review and edit before content goes live. For searching, the agent uses semantic and keyword hybrid search, which means you can describe what you're looking for in plain language rather than exact titles. Updating existing documents is equally straightforward -- point the agent to a document URL and describe what you want changed, and it will fetch the current content, apply your edits, and show you the diff.

A few tips for effective use: always specify which server you're targeting if it's not the default hyper.media -- for example, _"publish to seedteamtalks.hyper.media"_. When working with multiple signing keys, tell the agent which identity to use upfront to avoid confusion. If you want the agent to cite other Seed documents in your content, mention that explicitly and it will search for relevant references and embed them as hypermedia links. You can also chain operations naturally -- a prompt like _"read the document at hyper.media/tech-talks/server-specs, summarize it, and post the summary as a comment"_ works as a single request.

Which Method Should I Choose?

Use the universal installer if you work with multiple AI agents or want full control over when updates happen. Use the Claude Code marketplace if you only use Claude Code and want automatic updates. Both methods install the same skills with the same capabilities.

Do you like what you are reading?. Subscribe to receive updates.

Unsubscribe anytime