Agent skill

Search Config

by alsk1992 in alsk1992/CloddsBot

Search indexing configuration and full-text search management

MITAuto-check passedBackend & APIs

Install Search Config

skills CLI
$ npx skills add alsk1992/CloddsBot --skill search-config -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alsk1992/CloddsBot search-config --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alsk1992/CloddsBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/skills/bundled/search-config .claude/skills/search-config && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
search-config
GitHub stars
3k
Token cost
~1.4k tokens
SKILL.md length
129 words
Files
2
Skills in repo
116
Repo updated
First seen
Licence
MIT

At a glance

Search indexing configuration and full-text search management

  • Works in 5 steps: Use hybrid search — Best results for… → Rebuild periodically — Keep indexes fresh → Optimize after bulk inserts — Improve… → …
  • Tasks that involve Search implementation
  • SKILL.md covers Chat Commands, TypeScript API Reference, Search Backends and Search Modes, plus 2 more sections
  • Runs TypeScript scripts from its folder; needs TYPESENSE_API_KEY

What it does

Search Config is an agent skill from alsk1992/CloddsBot. Search indexing configuration and full-text search management

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `index.ts`).

It sits in Backend & APIs, covering Search implementation. The repository describes itself as: Open Source AI trading agent that operates autonomously across 1000+ markets - Polymarket, Kalshi, Binance, Hyperliquid, Solana DEXs, 5 EVM chains. Scans for edge, executes… The licence is MIT.

When your agent uses it

  • Tasks that involve Search implementation

Example prompts

  • “/search-config”

Requirements

  • Node.js
  • A credential in TYPESENSE_API_KEY

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Use hybrid search — Best results for most queries
  2. Rebuild periodically — Keep indexes fresh
  3. Optimize after bulk inserts — Improve performance
  4. Monitor latency — Scale if too slow
  5. Tune weights — Adjust semantic/fulltext balance

What it can do on your machine

Read from SKILL.md and the folder at commit c930628. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (TypeScript), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TYPESENSE_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Search Config loads about 1.4k tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 129 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~19
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alsk1992/CloddsBot at commit c930628, republished under its MIT licence (© alsk1992). 129 words, ~1,381 tokens.

Download SKILL.mdSave it as .claude/skills/search-config/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
search-config
description
Search indexing configuration and full-text search management
emoji
🔎

Search Config - Complete API Reference

Configure search indexing, manage search backends, and optimize full-text search.


Chat Commands

View Status
/search-config                              Show search config
/search-config status                       Index status
/search-config stats                        Search statistics
Index Management
/search-config rebuild                      Rebuild all indexes
/search-config rebuild memories             Rebuild specific index
/search-config optimize                     Optimize indexes
/search-config clear <index>                Clear index
Configuration
/search-config backend sqlite               Set backend
/search-config backend elasticsearch        Use Elasticsearch
/search-config mode hybrid                  Set search mode
/search-config boost semantic 0.7           Set semantic weight

TypeScript API Reference

Create Search Service
typescript
import { createSearchService } from 'clodds/search';

const search = createSearchService({
  // Backend
  backend: 'sqlite',  // 'sqlite' | 'elasticsearch' | 'typesense' | 'meilisearch'

  // Search mode
  mode: 'hybrid',  // 'fulltext' | 'semantic' | 'hybrid'

  // Hybrid weights
  semanticWeight: 0.6,
  fulltextWeight: 0.4,

  // Embedding provider (for semantic)
  embeddings: {
    provider: 'openai',
    model: 'text-embedding-3-small',
  },

  // Storage
  dbPath: './search.db',
});
Index Documents
typescript
// Index single document
await search.index({
  collection: 'memories',
  id: 'mem-1',
  content: 'User prefers conservative trading',
  metadata: {
    type: 'preference',
    userId: 'user-123',
  },
});

// Index batch
await search.indexBatch({
  collection: 'documents',
  documents: [
    { id: 'doc-1', content: 'First document', metadata: {} },
    { id: 'doc-2', content: 'Second document', metadata: {} },
  ],
});
typescript
// Full-text search
const results = await search.search({
  query: 'trading strategies',
  collection: 'documents',
  limit: 10,
});

for (const result of results) {
  console.log(`${result.id}: ${result.score}`);
  console.log(`  ${result.snippet}`);
}

// With filters
const results = await search.search({
  query: 'bitcoin',
  collection: 'news',
  filters: {
    date: { gte: '2024-01-01' },
    source: 'reuters',
  },
  limit: 20,
});
typescript
// Combine full-text and semantic
const results = await search.hybridSearch({
  query: 'how to manage risk in trading',
  collection: 'documents',
  semanticWeight: 0.7,
  fulltextWeight: 0.3,
  limit: 10,
});
Get Index Stats
typescript
const stats = await search.getStats();

console.log('Index Statistics:');
for (const [collection, info] of Object.entries(stats.collections)) {
  console.log(`${collection}:`);
  console.log(`  Documents: ${info.documentCount}`);
  console.log(`  Size: ${info.sizeMB} MB`);
  console.log(`  Last indexed: ${info.lastIndexed}`);
}

console.log(`\nSearch Stats:`);
console.log(`  Queries today: ${stats.queriesToday}`);
console.log(`  Avg latency: ${stats.avgLatencyMs}ms`);
console.log(`  Cache hit rate: ${stats.cacheHitRate}%`);
Rebuild Index
typescript
// Rebuild all indexes
await search.rebuildAll();

// Rebuild specific collection
await search.rebuild('memories');

// With progress callback
await search.rebuild('documents', {
  onProgress: (progress) => {
    console.log(`${progress.current}/${progress.total} (${progress.percent}%)`);
  },
});
Optimize Index
typescript
// Optimize for better performance
await search.optimize();

// Optimize specific collection
await search.optimize('documents');
Clear Index
typescript
// Clear specific collection
await search.clear('memories');

// Clear all
await search.clearAll();
Configure Backend
typescript
// Switch to Elasticsearch
await search.setBackend('elasticsearch', {
  url: process.env.ELASTICSEARCH_URL,
  index: 'clodds',
});

// Switch to Typesense
await search.setBackend('typesense', {
  url: process.env.TYPESENSE_URL,
  apiKey: process.env.TYPESENSE_API_KEY,
});

Search Backends

BackendBest ForFeatures
SQLiteDevelopment, small dataSimple, embedded
ElasticsearchProduction, large dataScalable, powerful
TypesenseFast searchTypo tolerance
MeilisearchInstant searchEasy setup

Search Modes

ModeDescription
fulltextTraditional keyword matching
semanticVector similarity search
hybridCombined (best of both)

Hybrid Search Weights

typescript
// More emphasis on meaning
const results = await search.hybridSearch({
  query: 'risk management',
  semanticWeight: 0.8,  // 80% semantic
  fulltextWeight: 0.2,  // 20% keyword
});

// More emphasis on exact matches
const results = await search.hybridSearch({
  query: 'BTCUSDT',
  semanticWeight: 0.2,  // 20% semantic
  fulltextWeight: 0.8,  // 80% keyword
});

Best Practices

  1. Use hybrid search — Best results for most queries
  2. Rebuild periodically — Keep indexes fresh
  3. Optimize after bulk inserts — Improve performance
  4. Monitor latency — Scale if too slow
  5. Tune weights — Adjust semantic/fulltext balance

© alsk1992, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in src/skills/bundled/search-config of alsk1992/CloddsBot.

  • SKILL.md
  • index.ts

Open the folder on GitHubat commit c930628

Compare with similar skills

Search Config next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Search Config compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Search Config this skillalsk1992/CloddsBot3k—~1.4kAutomated safety check: PassMIT
Firecrawl Search Integrationfirecrawl/firecrawl190k1 repos~1.1kAutomated safety check: PassISC
Product Full-Text Searchlobehub/lobehub83k—~4.1kAutomated safety check: PassCustom licence
Hackernewssigcli/sigcli293—~2kAutomated safety check: PassMIT
Create Skillxlanex6/nuxt-meilisearch123—~752Automated safety check: PassMIT
Foundatio Repositoriesexceptionless/Exceptionless2.5k—~1.9kAutomated safety check: PassApache-2.0

Similar skills

  • Firecrawl Search Integration

    firecrawl/firecrawl

    Guidance for adding Firecrawl's /search endpoint to product code and agent workflows when a feature starts from a query rather than a URL.

    190k GitHub starsUsed in 1 repo~1.1k tokens
    Backend & APIsAuto-check passed
  • Guides work on LobeHub's own product search: the shared search repository, provider choice, Elasticsearch mappings, change syncing and reindexing.

    83k GitHub stars~4.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Hackernews

    sigcli/sigcli

    Interact with Hacker News (news.ycombinator.com) — browse top, new, and best stories, read item details and comment threads, look up user profiles, and search posts via Algolia.

    293 GitHub stars~2k tokensUpdated 13 days ago
    Backend & APIsAuto-check passed
  • Create Skill

    xlanex6/nuxt-meilisearch

    Guide for creating effective skills following best practices.

    123 GitHub stars~752 tokensUpdated 3 mo ago
    Backend & APIsAuto-check passed
  • Foundatio Repositories

    exceptionless/Exceptionless

    Query, aggregate, patch, or paginate Exceptionless data through its Elasticsearch repository abstractions.

    2.5k GitHub stars~1.9k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Meilisearch

    xlanex6/nuxt-meilisearch

    Meilisearch open-source search engine with full-text, semantic, and hybrid search, filtering, faceting, and typo tolerance.

    123 GitHub stars~1.1k tokensUpdated 3 mo ago
    Backend & APIsAuto-check passed

More from alsk1992/CloddsBot

All 116 skills in this repo
  • Qmd

    alsk1992/CloddsBot

    Local hybrid search for markdown notes and docs. An agent skill from alsk1992/CloddsBot.

    3k GitHub starsUsed in 3 repos~1.2k tokens
    Auto-check passed
  • AI Strategy

    alsk1992/CloddsBot

    AI Strategy - natural language to trades. An agent skill from alsk1992/CloddsBot.

    3k GitHub stars~670 tokensUpdated 8 days ago
    Auto-check passed
  • Alerts

    alsk1992/CloddsBot

    Create and manage price alerts for prediction markets. An agent skill from alsk1992/CloddsBot.

    3k GitHub stars~460 tokensUpdated 8 days ago
    Auto-check passed
  • Analytics

    alsk1992/CloddsBot

    Performance attribution, trade analytics, and strategy optimization

    3k GitHub stars~1.6k tokensUpdated 8 days ago
    Auto-check passed
  • Arbitrage

    alsk1992/CloddsBot

    Automated cross-platform arbitrage detection and monitoring. An agent skill from alsk1992/CloddsBot.

    3k GitHub stars~1.7k tokensUpdated 8 days ago
    Auto-check passed
  • Auto Reply

    alsk1992/CloddsBot

    Automatic response rules, patterns, and scheduled messages. An agent skill from alsk1992/CloddsBot.

    3k GitHub stars~1.5k tokensUpdated 8 days ago
    Auto-check passed

Categories

Questions about Search Config

What does Search Config do?

Search indexing configuration and full-text search management. Search Config is an agent skill from alsk1992/CloddsBot.

When should I use Search Config?

Search Config fits situations like: tasks that involve Search implementation.

How do I install Search Config in Claude Code?

Run `npx skills add alsk1992/CloddsBot --skill search-config -a claude-code`. Or copy the skill folder (src/skills/bundled/search-config in alsk1992/CloddsBot) into .claude/skills/search-config in your project. Claude Code loads it when a task matches its description.

How do I install Search Config in Codex?

Run `npx skills add alsk1992/CloddsBot --skill search-config -a codex`. Or copy the skill folder (src/skills/bundled/search-config in alsk1992/CloddsBot) into .agents/skills/search-config in your project. Codex loads it when a task matches its description.

Can I use Search Config in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alsk1992/CloddsBot --skill search-config -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/search-config, .gemini/skills/search-config, .github/skills/search-config and .opencode/skills/search-config in your project.

What does Search Config need to run?

Going by SKILL.md and its folder, Search Config needs TypeScript for the scripts in its folder and credentials named TYPESENSE_API_KEY. Our summary lists: Node.js; A credential in TYPESENSE_API_KEY.

Does Search Config access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Search Config safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Search Config use?

Search Config is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Search Config use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Search Config?

Skills that share tags, products or a category with Search Config: Firecrawl Search Integration (firecrawl/firecrawl, 190k stars), Product Full-Text Search (lobehub/lobehub, 83k stars), Hackernews (sigcli/sigcli, 293 stars) and Create Skill (xlanex6/nuxt-meilisearch, 123 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Search Config?

alsk1992 (a GitHub user) maintains it in alsk1992/CloddsBot, which has 2,951 GitHub stars. The repository holds 116 skills in this directory. The repository was last updated on October 2, 2026.

Source: alsk1992/CloddsBot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.