Run any Skill in Manus with one click

Get Started

entity-query

Stars26

Forks7

UpdatedMarch 27, 2026 at 11:24

Query the workspace `entities/` tree with helper scripts before manually reading many records.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

benschrauwen

benschrauwen/hermit

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

7 files

SKILL.md

readonly

name	entity-query
description	Query the workspace `entities/` tree with helper scripts before manually reading many records.

Entity Query

Use when:

You need to search, sort, count, or inventory many entities.

Do not use when:

You already know the exact file.
An exact text search on known paths is enough.
The task is a single-record edit.

Steps:

Run summarize-entities.ts for counts and rollups.
Run query-entities.ts to narrow candidates.
Run query-graph.ts when you need relationship traversal, broken-reference checks, or path finding.
Read only the returned record.md files.
Run inventory-entities.ts only if you need typical companion files.
Use rg on narrowed paths for exact text.

Commands:

node --import tsx skills/entity-query/scripts/summarize-entities.ts --top 10
node --import tsx skills/entity-query/scripts/query-entities.ts --type deal --status qualification --sort updated --desc --limit 20
node --import tsx skills/entity-query/scripts/query-graph.ts --role sales --query summary
node --import tsx skills/entity-query/scripts/query-graph.ts --role sales --query neighbors --entity deal-acme-enterprise --direction both
node --import tsx skills/entity-query/scripts/inventory-entities.ts --group-by type --top 8

Key flags:

query-entities.ts: --type, --status, --owner, --directory, --id, --name, --text, --sort, --desc, --limit, --format table|json|paths
query-graph.ts: --role, --query summary|neighbors|subgraph|path|broken, --entity, --from, --to, --direction incoming|outgoing|both, --edge-type, --depth, --max-depth, --format text|json
summarize-entities.ts: --type, --status, --owner, --directory, --top, --format text|json
inventory-entities.ts: --type, --directory, --group-by type|directory|top-level, --top, --format text|json

Notes:

Run from the workspace root. In the default nested setup that is workspace/. Otherwise pass --root /absolute/path/to/workspace.
These scripts scan the workspace entities/ tree for record.md.
Frontmatter fields like id, type, name, status, owner, and updated_at are used when present.
query-graph.ts builds the relationship graph in memory on demand from the current markdown state; it does not persist an index.

More from this repository

same repository

entity-setup

benschrauwen/hermit

Define Hermit entity schema, templates, and starter records.

2026-04-2126

openai-tts

benschrauwen/hermit

Generate short spoken audio files from text with OpenAI text-to-speech. Use when you want a Telegram voice-note reply or any local speech audio from text.

2026-03-2926

telegram-voice-transcription

benschrauwen/hermit

Transcribe saved Telegram voice notes and other audio attachments with OpenAI before replying. Use when a Telegram prompt includes an audio file path under inbox/telegram/.

2026-03-2926

role-setup

benschrauwen/hermit

Define Hermit roles, including `role.md`, `AGENTS.md`, prompts, and startup files.

2026-03-2726

framework-maintenance

benschrauwen/hermit

Maintain the Hermit framework repo separately from workspace data, including framework PR and update flows.

2026-03-2426

find-skills

benschrauwen/hermit

Search `skills.sh` and ClawHub for reusable skills, then install only after user confirmation.

2026-03-1426

Entity Query

Use when:

You need to search, sort, count, or inventory many entities.

Do not use when:

You already know the exact file.

An exact text search on known paths is enough.

The task is a single-record edit.

Steps:

Run summarize-entities.ts for counts and rollups.

Run query-entities.ts to narrow candidates.

Run query-graph.ts when you need relationship traversal, broken-reference checks, or path finding.

Read only the returned record.md files.

Run inventory-entities.ts only if you need typical companion files.

Use rg on narrowed paths for exact text.

Commands:

node --import tsx skills/entity-query/scripts/summarize-entities.ts --top 10 node --import tsx skills/entity-query/scripts/query-entities.ts --type deal --status qualification --sort updated --desc --limit 20 node --import tsx skills/entity-query/scripts/query-graph.ts --role sales --query summary node --import tsx skills/entity-query/scripts/query-graph.ts --role sales --query neighbors --entity deal-acme-enterprise --direction both node --import tsx skills/entity-query/scripts/inventory-entities.ts --group-by type --top 8

Key flags:

query-entities.ts: --type, --status, --owner, --directory, --id, --name, --text, --sort, --desc, --limit, --format table|json|paths

summarize-entities.ts: --type, --status, --owner, --directory, --top, --format text|json

inventory-entities.ts: --type, --directory, --group-by type|directory|top-level, --top, --format text|json

Notes:

Run from the workspace root. In the default nested setup that is workspace/. Otherwise pass --root /absolute/path/to/workspace.

These scripts scan the workspace entities/ tree for record.md.

Frontmatter fields like id, type, name, status, owner, and updated_at are used when present.

query-graph.ts builds the relationship graph in memory on demand from the current markdown state; it does not persist an index.