Skip to main content

​
Why Octen Skills

Octen Skills put Octen inside your agent: live broad web search and UI design references with clean, model-ready context.

Fast

Web search averages 62ms. Fast enough for multi-step agent workflows.

Accurate

Powered by SOTA text and VL embedding models. Better sources, fewer hallucinations.

Fresh

Live web data with minute-level updates. Useful for news, prices, and fast-moving pages.

Efficient

Clean highlights, optional full content, and time and domain filters keep model context relevant.

​
Get started

Get API Key

Create a key from the API Platform.

GitHub

View and install the skills.

​
Skills

SkillEndpointUse for
octen-searchPOST /broad-search, POST /searchSearch bars, answer engines, news lookup, and broad multi-angle research.
octen-image-searchPOST /image-searchImage lookup and visual references. Invite-only beta — contact us for access.
octen-video-searchPOST /video-searchVideo lookup, clip discovery, and media previews. Invite-only beta — contact us for access.
octen-extractPOST /extractReading pages, cleaning articles, and knowledge ingestion.
octen-designPOST /image-searchUI design references and inspiration for frontends. Invite-only beta — contact us for access.

​
Installation

npx skills add Octen-Team/octen-skills -a claude-code

​
Without Node (curl)

If you can’t run npx, copy the skills/ directory into your agent’s skills folder: 
mkdir -p <skills-dir> && \
  curl -sL https://github.com/Octen-Team/octen-skills/archive/main.tar.gz | \
  tar xz -C <skills-dir> --strip-components=2 octen-skills-main/skills

​
API key

Set OCTEN_API_KEY before using either skill. Get a key from the API Platform.
Add to ~/.claude/settings.json:
{
  "env": {
    "OCTEN_API_KEY": "your-key"
  }
}
For per-project use, add the same env block to .claude/settings.local.json.
curl -s -X POST "https://api.octen.ai/broad-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{"query": "latest AI research 2026", "count": 5}'
For broad, multi-angle coverage, pass the full question as-is — Octen expands it into sub-queries searched concurrently and returns results grouped per sub-query: 
curl -s -X POST "https://api.octen.ai/broad-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "query": "compare cloud GPU pricing across major providers",
    "max_queries": 5,
    "search_options": {"count": 10, "highlight": {"enable": true}}
  }'

​
octen-image-search — invite-only beta

Image lookup, visual references, and design assets — search by text or a reference image. 
curl -s -X POST "https://api.octen.ai/image-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "inputs": [{"type": "text", "data": "red sports car"}],
    "count": 5
  }'

​
octen-video-search — invite-only beta

Video lookup, clip discovery, and media previews. 
curl -s -X POST "https://api.octen.ai/video-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "inputs": [{"type": "text", "data": "how to make espresso"}],
    "count": 5
  }'

​
octen-extract

curl -s -X POST "https://api.octen.ai/extract" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "urls": ["https://example.com", "https://octen.ai"],
    "format": "markdown"
  }'

​
octen-design — invite-only beta

Find real UI references — each design hit returns a reference image, a structured style summary, and a reusable html_snippet. 
curl -s -X POST "https://api.octen.ai/image-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "inputs": [{"type": "text", "data": "pricing comparison table, dark theme, SaaS"}],
    "topic": "design",
    "count": 5,
    "html_snippet": {"enable": true, "max_tokens": 5000}
  }'

​
When to use each skill

NeedSkill
Comprehensive, multi-angle researchocten-search (broad search)
A quick web searchocten-search
Recent news or fast-changing topicsocten-search with time filters
Results scoped to specific sitesocten-search with include_domains
Photos, diagrams, or visual referencesocten-image-search (beta)
Videos, clips, or a moment within a videoocten-video-search (beta)
Reading known URLs as clean contentocten-extract
UI reference, style tokens, or HTML/CSSocten-design (beta)