Agent skill

Ade Search

by arul28 in arul28/ADE

A skill your agent uses to search project-backed ADE chats across registered projects and search the active project's terminals, PRs, commits, branches, lanes, files, Linear issues, and proof…

AGPL-3.0Auto-check passed

Install Ade Search

skills CLI
$ npx skills add arul28/ADE --skill ade-search -a claude-code

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

GitHub CLI
$ gh skill install arul28/ADE ade-search --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/arul28/ADE.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/desktop/resources/agent-skills/ade-search .claude/skills/ade-search && 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
ade-search
GitHub stars
114
Token cost
~1.6k tokens
SKILL.md length
679 words
Files
1
Skills in repo
28
Repo updated
First seen
Licence
AGPL-3.0

At a glance

A skill your agent uses to search project-backed ADE chats across registered projects and search the active project's terminals, PRs, commits, branches, lanes, files, Linear issues, and proof…

  • Search project-backed ADE chats across registered projects and search the active projects terminals
  • SKILL.md covers What it is, Command forms, Query syntax and Result kinds and where they…, plus 2 more sections
  • Calls git and kind
  • Proof artifacts via ade search instead of grepping .ade/ internals

What it does

Ade Search is an agent skill from arul28/ADE. Use this skill to search project-backed ADE chats across registered projects and search the active project's terminals, PRs, commits, branches, lanes, files, Linear issues, and proof artifacts via ade search instead of grepping .ade/ internals.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Linear. The licence is AGPL-3.0.

When your agent uses it

  • Search project-backed ADE chats across registered projects and search the active projects terminals
  • Proof artifacts via ade search instead of grepping .ade/ internals

Example prompts

  • “/ade-search”

What it can do on your machine

Read from SKILL.md and the folder at commit c14d06f. 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

    Shell commands in SKILL.md call:

    • git
    • kind

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Ade Search loads about 1.6k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 679 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
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 arul28/ADE at commit c14d06f, republished under its AGPL-3.0 licence (© arul28). 679 words, ~1,602 tokens.

Download SKILL.mdSave it as .claude/skills/ade-search/SKILL.md (or your agent's skills folder).
name
ade-search
description
Use this skill to search project-backed ADE chats across registered projects and search the active project's terminals, PRs, commits, branches, lanes, files, Linear issues, and proof artifacts via `ade search` instead of grepping .ade/ internals.

What it is

ade search queries deterministic full-text indexes maintained by ADE. Chat queries include project-backed chats from every project registered with the machine brain. Other kinds — terminal/CLI scrollback, PRs, commits, branches, lanes, workspace files, Linear issues, and proof artifacts — come from the active project. Personal/no-project chats are intentionally excluded and stay on the separate personal-chat surface.

This policy is identical for session-bound agents and unbound human shells; search does not silently narrow chat hits to the caller's own session. It is not a grep over .ade/: the runtime keeps each project index fresh and the machine router combines bounded chat result pages. Each project contributes at most its first 200 matches to one aggregate query; resultsTruncated: true (and the text-mode bounded: line) means you should narrow the query rather than assuming the tail was exhaustive. Every hit carries a deep link back to the exact ADE surface.

Use it instead of poking at .ade/ade.db, replaying git log, or asking the user "which chat was that in". It answers "where did this happen in ADE" across kinds in one call.

Command forms

bash
ade search "<query>"                       # ranked results as JSON (default)
ade search "<query>" --text                # aligned rows + count summary
ade search "<query>" --kind chat,terminal  # restrict to kinds
ade search "<query>" --lane fix-login      # restrict to a lane (id or name)
ade search "<query>" --limit 20            # cap result count
ade search "<query>" --cursor <nextCursor> # next page from a prior query
ade search --status --text                 # index doc counts + backfill state
ade search --rebuild --text                # rebuild the index (CTO-only)

Query syntax

The query string is passed through to the index. It supports:

FormMeaningExample
bare termsAND-ed togetherade search "retry backoff"
"quoted phrase"exact adjacent phraseade search '"connection refused"'
kind:<kind>restrict to a kind inlineade search "kind:pr merge queue"
lane:<name>restrict to a lane inlineade search "lane:fix-login timeout"
session:<id>restrict to one sessionade search "session:abc123 panic"
since:<date>recency floor (ISO date)ade search "since:2026-06-01 crash"

Inline kind: / lane: filters and the --kind / --lane flags can be mixed; the flags are the scriptable form and validate their input.

Kind values: lane, chat, terminal, pr, commit, branch, file, linear, artifact. --kind takes a comma-separated list and rejects unknown kinds with a usage error (exit 2).

kinddeep-links to
chatthe Work chat session, scrolled to the matching message
terminalthe terminal/CLI session, at the matching scrollback offset
prthe PR detail tab
committhe commit in the lane's history
branchthe branch (find-or-offer-to-create lane)
lanethe lane
filethe workspace file
linearthe Linear pane for the issue
artifactthe proof/artifact in the proof drawer

Each result also carries laneId/laneName, sessionId, and updatedAt; the deepLink is an ade://… URL you can hand to ade open. Machine-routed results additionally carry projectId, projectName, and projectRoot so same-named lanes and chats remain distinguishable.

Show full SKILL.md (274 more words)Show less

Output modes

  • --json (default): the full SearchQueryResult — results[] (each with kind, id, title, snippet, matchRanges, laneId, laneName, sessionId, deepLink, updatedAt, and machine-routed project fields), totalByKind, nextCursor, and project coverage metadata. Use this when you need the deep link or want to page.
  • --text: aligned KIND PROJECT TITLE SNIPPET ID rows when project metadata is present, then a N results (chat 3, terminal 2, …) summary from totalByKind, and a more: --cursor <value> line when another page exists. Use this for a quick human-readable scan.

Exit codes are script-friendly: 0 when the query matched at least one result, 1 when it matched nothing (so ade search "x" >/dev/null && … works), and 2 on a usage error such as an unknown --kind.

When to use which

  • "Which chat discussed X?" → ade search "X" --kind chat --text, then ade open <deepLink> or read a bounded window with ade chat read <session> --limit 20 --max-chars 8000 --text. Use --page --cursor <nextCursor> only when you need older content.
  • "Which terminal ran the failing command?" → ade search "<command or error>" --kind terminal --text; the result offset drops you at the failure in scrollback.
  • "Find the PR discussing Y." → ade search "Y" --kind pr --text.
  • "Where in this lane did we touch Z?" → ade search "Z" --lane <lane> --text across files, commits, and chats.
  • Index looks stale or empty → ade search --status --text to see docCount, per-kind counts, and backfillComplete; rebuild with ade search --rebuild only if backfill is genuinely broken.

Reach for ade search before grepping .ade/ internals or asking the user to locate something. Remember the boundary: chats span registered projects; non-chat kinds use the active project; personal chats are excluded.

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

Files

Just SKILL.md in apps/desktop/resources/agent-skills/ade-search of arul28/ADE.

Open the folder on GitHubat commit c14d06f

Compare with similar skills

Ade Search 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.

Ade Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ade Search this skillarul28/ADE114—~1.6kAutomated safety check: PassAGPL-3.0
Orca Linear Ticket Workflowstablyai/orca88k1 repos~522Automated safety check: PassMIT
Review Triage Phaseprisma/orm48k—~995Automated safety check: PassApache-2.0
Commitdinerojs/dinero.js6.8k—~667Automated safety check: PassMIT
Draft Pull Request Creatorwordpress-mobile/WordPress-Android3.2k—~881Automated safety check: NotesGPL-2.0
Linear Tickets via Orcastablyai/orca88k—~558Automated safety check: PassMIT

Similar skills

  • Linear ticket work through Orca's CLI. Use when working from a linked Linear issue, finishing work with a PR/MR link and a completion comment, moving a ticket…

    88k GitHub starsUsed in 1 repo~522 tokens
    Productivity & AutomationAuto-check passed
  • Official

    Runs the triage step of the review-framework loop: reads fetched PR review state, builds `review-actions.json`, validates it and renders `review-actions.md`.

    48k GitHub stars~995 tokensUpdated today
    DevelopmentAuto-check passed
  • Commit

    dinerojs/dinero.js

    Create a git commit with optional automatic Linear issue linking.

    6.8k GitHub stars~667 tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Draft Pull Request Creator

    wordpress-mobile/WordPress-Android

    Commits and pushes current changes, writes a pull request title and body from the branch history and template, and opens a draft PR on GitHub after you approve it.

    3.2k GitHub stars~881 tokensUpdated today
    DevelopmentAuto-check: notes
  • Linear ticket work through Orca's CLI. Use when working from a linked Linear issue, finishing work with a PR/MR link and a completion comment, moving a ticket…

    88k GitHub stars~558 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Add Icon Mapping

    lobehub/lobe-icons

    Add or modify icon keyword mappings for providers, models, or agents in lobe-icons.

    2.6k GitHub stars~1.5k tokensUpdated yesterday
    MobileAuto-check: warnings

More from arul28/ADE

All 28 skills in this repo
  • Ade App Control

    arul28/ADE

    A skill your agent uses when you need to run or drive a local Electron/desktop app and capture what it does — launch it or attach to a running renderer, read its logs or answer its terminal prompts…

    114 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Iteratively optimize an ADE tab's CPU/memory/IPC/render performance.

    114 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Ade Browser

    arul28/ADE

    A skill your agent uses for any browser behavior at all — opening a URL, checking a localhost page, clicking or filling a form, logging in, screenshotting, inspecting the DOM, or verifying a page…

    114 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Ade Deeplinks

    arul28/ADE

    A skill your agent uses when an agent needs to mint, share, or open ADE deeplinks (lane, work session, file, commit, artifact, branch, PR, Linear issue) so users — or the agent itself — can jump…

    114 GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • Ade Harnesses

    arul28/ADE

    A skill your agent uses when you need to run a chat, a CLI session, or a subagent on a specific setup — any model you pay for inside any harness (e.g.

    114 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Ade Lanes Git

    arul28/ADE

    A skill your agent uses when creating, inspecting, syncing, committing, pushing, archiving, or rebasing ADE lanes and lane worktrees through ade lanes and ade git.

    114 GitHub stars~594 tokensUpdated today
    Auto-check passed

Works with

Questions about Ade Search

What does Ade Search do?

A skill your agent uses to search project-backed ADE chats across registered projects and search the active project's terminals, PRs, commits, branches, lanes, files, Linear issues, and proof…. Ade Search is an agent skill from arul28/ADE.ade/ internals.

When should I use Ade Search?

Ade Search fits situations like: search project-backed ADE chats across registered projects and search the active projects terminals; proof artifacts via ade search instead of grepping .ade/ internals.

How do I install Ade Search in Claude Code?

Run `npx skills add arul28/ADE --skill ade-search -a claude-code`. Or copy the skill folder (apps/desktop/resources/agent-skills/ade-search in arul28/ADE) into .claude/skills/ade-search in your project. Claude Code loads it when a task matches its description.

How do I install Ade Search in Codex?

Run `npx skills add arul28/ADE --skill ade-search -a codex`. Or copy the skill folder (apps/desktop/resources/agent-skills/ade-search in arul28/ADE) into .agents/skills/ade-search in your project. Codex loads it when a task matches its description.

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

What does Ade Search need to run?

Going by SKILL.md and its folder, Ade Search needs the command-line tools its instructions call (git and kind).

Does Ade Search access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ade Search 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 Ade Search use?

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

How many tokens does Ade Search use?

About 1.6k tokens (SKILL.md is roughly 6.4k 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 Ade Search?

Skills that share tags, products or a category with Ade Search: Orca Linear Ticket Workflow (stablyai/orca, 88k stars), Review Triage Phase (prisma/orm, 48k stars), Commit (dinerojs/dinero.js, 6.8k stars) and Draft Pull Request Creator (wordpress-mobile/WordPress-Android, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ade Search?

arul28 (a GitHub user) maintains it in arul28/ADE, which has 114 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 9, 2026.

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