Agent skill

Gno

by gmickel in gmickel/gno

Search local documents, files, notes, and knowledge bases. An agent skill from gmickel/gno.

MITAuto-check passedKnowledge Management

Install Gno

skills CLI
$ npx skills add gmickel/gno --skill gno -a claude-code

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

GitHub CLI
$ gh skill install gmickel/gno gno --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/gmickel/gno.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gno .claude/skills/gno && 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
gno
GitHub stars
115
Used in
1 other repo
Token cost
~1.6k tokens
SKILL.md length
426 words
Files
4
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Search local documents, files, notes, and knowledge bases. An agent skill from gmickel/gno.

  • User wants to search files
  • SKILL.md covers When to Use This Skill, Quick Start, Command Overview and Search Modes, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Look up information in local folders

What it does

Gno is an agent skill from gmickel/gno. Search local documents, files, notes, and knowledge bases. Index directories, search with BM25/vector/hybrid, get AI answers with citations. Use when user wants to search files, find documents, query notes, look up information in local folders, index a directory, set up document search, build a knowledge base, needs RAG/semantic search, or wants to start a local web UI for their docs.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `cli-reference.md`, `examples.md` and `mcp-reference.md`).

It sits in Knowledge Management, covering Knowledge bases, Embeddings and Frontend development. It works with Model Context Protocol and TypeScript. The repository describes itself as: Local AI-powered document search and editing with first-in-class hybrid retrieval, LLM answers, WebUI, REST API and MCP support for AI clients. The licence is MIT.

When your agent uses it

  • User wants to search files
  • Look up information in local folders
  • Index a directory
  • Set up document search

Example prompts

  • “/gno”

Requirements

  • Pre-approved tools (allowed-tools): Bash(gno:*), Read

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(gno:*)
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    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 no API keys, tokens, secrets or passwords.

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

Context cost

Gno loads about 1.6k tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 426 words of instructions outside code blocks.

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

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 gmickel/gno at commit 595924c, republished under its MIT licence (© gmickel). 426 words, ~1,575 tokens.

Download SKILL.mdSave it as .claude/skills/gno/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
gno
description
Search local documents, files, notes, and knowledge bases. Index directories, search with BM25/vector/hybrid, get AI answers with citations. Use when user wants to search files, find documents, query notes, look up information in local folders, index a directory, set up document search, build a knowledge base, needs RAG/semantic search, or wants to start a local web UI for their docs.
allowed-tools
Bash(gno:*), Read

GNO - Local Knowledge Engine

Fast local semantic search. Index once, search instantly. No cloud, no API keys.

When to Use This Skill

  • User asks to search files, documents, or notes
  • User wants to find information in local folders
  • User needs to index a directory for searching
  • User mentions PDFs, markdown, Word docs, code to search
  • User asks about knowledge base or RAG setup
  • User wants semantic/vector search over their files
  • User needs to set up MCP for document access
  • User wants a web UI to browse/search documents
  • User asks to get AI answers from their documents
  • User wants to tag, categorize, or filter documents
  • User asks about backlinks, wiki links, or related notes
  • User wants to visualize document connections or see a knowledge graph
  • User wants to export a note or collection for gno.sh publishing

Quick Start

bash
gno init                              # Initialize in current directory
gno collection add ~/docs --name docs # Add folder to index
gno index                             # Build index (ingest + embed)
gno search "your query"               # BM25 keyword search

Command Overview

CategoryCommandsDescription
Searchsearch, vsearch, query, askFind documents by keywords, meaning, or get AI answers
Linkslinks, backlinks, similar, graphNavigate document relationships and visualize connections
Retrieveget, multi-get, lsFetch document content by URI or ID
Indexinit, collection add/list/remove, index, update, embedSet up and maintain document index
Tagstags, tags add, tags rmOrganize and filter documents
Contextcontext add/list/rm/checkAdd hints to improve search relevance
Modelsmodels list/use/pull/clear/pathManage local AI models
ServeserveWeb UI for browsing and searching
Publishpublish exportExport gno.sh publish artifacts
MCPmcp, mcp install/uninstall/statusAI assistant integration
Skillskill install/uninstall/show/pathsInstall skill for AI agents
Adminstatus, doctor, cleanup, reset, vec, completionMaintenance and diagnostics
Show full SKILL.md (169 more words)Show less

Search Modes

CommandSpeedBest For
gno searchinstantExact keyword matching
gno vsearch~0.5sFinding similar concepts
gno query --fast~0.7sQuick lookups
gno query~2-3sBalanced (default)
gno query --thorough~5-8sBest recall, complex queries
gno ask --answer~3-5sAI-generated answer with citations

Retry strategy: Use default first. If no results: rephrase query, then try --thorough.

Common Flags

-n <num>              Max results (default: 5)
-c, --collection      Filter to collection
--tags-any <t1,t2>    Has ANY of these tags
--tags-all <t1,t2>    Has ALL of these tags
--json                JSON output
--files               URI list output
--line-numbers        Include line numbers

Global Flags

--index <name>    Alternate index (default: "default")
--config <path>   Override config file
--verbose         Verbose logging
--json            JSON output
--yes             Non-interactive mode
--offline         Use cached models only
--no-color        Disable colors
--no-pager        Disable paging

Index names follow the CLI filesystem-identity contract: 1–64 UTF-16 code units, letter/number first, no trailing space or ., no .., separators, or platform-invalid punctuation. NFC/case-equivalent names share one identity. See docs/CLI.md under Global Options for the complete byte limits.

Non-default index search results may include ?index=<name> on gno:// URIs. Keep that query string when passing the URI to gno get.

Important: Embedding After Changes

If you edit/create files that should be searchable via vector search:

bash
gno index              # Full re-index (sync + embed)
# or
gno embed              # Embed only (if already synced)

MCP gno.sync and gno.capture do NOT auto-embed. Use CLI for embedding.

Reference Documentation

TopicFile
Complete CLI reference (all commands, options, flags)cli-reference.md
MCP server setup and toolsmcp-reference.md
Usage examples and patternsexamples.md

© gmickel, 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 3 other files in skills/gno of gmickel/gno.

  • SKILL.md
  • cli-reference.md
  • examples.md
  • mcp-reference.md

Open the folder on GitHubat commit 595924c

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in gmickel/gno, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Gno 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.

Gno compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gno this skillgmickel/gno1151 repos~1.6kAutomated safety check: PassMIT
Azure Search Documents TSmicrosoft/skills3.1k—~1.8kAutomated safety check: PassMIT
Documentation Serverandrea9293/mcp-documentation-server343—~2.3kAutomated safety check: PassMIT
Docsmint Document ManagerHiAi-gg/docsmint118—~584Automated safety check: PassApache-2.0
Vault Contextual RetrievalAgriciDaniel/claude-obsidian15k—~1.4kAutomated safety check: PassMIT
Knowledge Queryevolution-foundation/evo-nexus545—~804Automated safety check: NotesCustom licence

Similar skills

  • Official

    Build search applications using Azure AI Search SDK for JavaScript (@azure/search-documents).

    3.1k GitHub stars~1.8k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Documentation Server

    andrea9293/mcp-documentation-server

    A skill your agent uses when you need to store, retrieve, search, or manage documents in a local knowledge base with semantic search and hybrid (vector + full-text) retrieval.

    343 GitHub stars~2.3k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Manage and research DocsMint documents through its scoped MCP tools, including categories, folders, hybrid search, GraphRAG, rerank, and index refresh.

    118 GitHub stars~584 tokensUpdated 11 days ago
    Knowledge ManagementAuto-check passed
  • Vault Contextual Retrieval

    AgriciDaniel/claude-obsidian

    Builds and queries a local contextual BM25 index over an Obsidian vault, with optional Nomic reranking through Ollama and strict consent rules before any text leaves the machine.

    15k GitHub stars~1.4k tokensUpdated 29 days ago
    Knowledge ManagementAuto-check passed
  • Knowledge Query

    evolution-foundation/evo-nexus

    Hybrid search (vector + BM25 via RRF + metadata boost) against the pgvector Knowledge base, with optional RAG synthesis.

    545 GitHub stars~804 tokensUpdated 4 mo ago
    AI & LLM EngineeringAuto-check: notes
  • Agent Squad for TypeScript

    2FastLabs/agent-squad

    Guide to building Node.js and TypeScript apps on the agent-squad package: orchestrator, agent types, classifier routing, storage, retrievers and MCP tools.

    7.8k GitHub stars~4.3k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

More from gmickel/gno

  • Gno

    gmickel/gno

    Search local documents, files, notes, and knowledge bases. An agent skill from gmickel/gno.

    115 GitHub stars~11k tokensUpdated 2 days ago
    Auto-check passed

Questions about Gno

What does Gno do?

Search local documents, files, notes, and knowledge bases. An agent skill from gmickel/gno. Gno is an agent skill from gmickel/gno. Search local documents, files, notes, and knowledge bases.

When should I use Gno?

Gno fits situations like: user wants to search files; look up information in local folders; index a directory; set up document search.

How do I install Gno in Claude Code?

Run `npx skills add gmickel/gno --skill gno -a claude-code`. Or copy the skill folder (skills/gno in gmickel/gno) into .claude/skills/gno in your project. Claude Code loads it when a task matches its description.

How do I install Gno in Codex?

Run `npx skills add gmickel/gno --skill gno -a codex`. Or copy the skill folder (skills/gno in gmickel/gno) into .agents/skills/gno in your project. Codex loads it when a task matches its description.

Can I use Gno 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 gmickel/gno --skill gno -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gno, .gemini/skills/gno, .github/skills/gno and .opencode/skills/gno in your project.

What does Gno need to run?

SKILL.md names no scripts, command-line tools or credentials: Gno is instructions for the agent only. Its frontmatter pre-approves these tools: Bash(gno:*), Read.

Does Gno 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 Gno 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 Gno use?

Gno 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 Gno use?

About 1.6k tokens (SKILL.md is roughly 6.3k 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 Gno?

Skills that share tags, products or a category with Gno: Azure Search Documents TS (microsoft/skills, 3.1k stars), Documentation Server (andrea9293/mcp-documentation-server, 343 stars), Docsmint Document Manager (HiAi-gg/docsmint, 118 stars) and Vault Contextual Retrieval (AgriciDaniel/claude-obsidian, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gno?

gmickel (a GitHub user) maintains it in gmickel/gno, which has 115 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 7, 2026.

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