narrative-io/narrative-skills-marketplace / plugins/narrative-common/skills/find-attribute
find-attribute
VerifiedFind the canonical Rosetta Stone attribute that best matches a fuzzy description, semantic phrase, or required schema shape. Searches the catalog with pagination, describes the shortlist in one batched call, ranks candidates by name + shape match, and returns the canonical attribute ID plus close alternatives. Use when: "find the X attribute", "what's the graph-edge attribute ID", "look up the email Rosetta Stone attribute", "search the attribute catalog for Y", "which attribute has SOURCE_ID + TARGET_ID + IS_DIRECTED". (narrative-common)
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.4 KB |
| SKILL.md.tmpl | other | 13.3 KB |
| references/EDGE_CASES.md | markdown | 2.0 KB |
| references/HARNESS_FALLBACK.md | markdown | 2.0 KB |
| references/HARNESS_FALLBACK.md.tmpl | other | 1.4 KB |
references/EDGE_CASES.md
View on GitHub# Edge cases and gotchas
Read when a search feels off — the snippet doesn't describe an
enum-constrained attribute, shape matching is rejecting candidates
that look fine on name, pagination yields nothing, the phrase is
genuinely ambiguous, or the caller is looking for a custom (non-
Rosetta-Stone) attribute.
## Catalog snippets lie about enum constraints
The search result description is truncated and may omit enum
values. Always call `narrative_attributes_describe` (phase 3) before
claiming any enum-constrained attribute matches the user's intent.
## Shape matching is by name, casing-insensitive
A catalog attribute with `source_id` matches `--shape SOURCE_ID`.
But matching is structural — extra columns are allowed (and counted
in the tiebreaker), missing columns are disqualifying.
## Pagination is opt-in
`narrative_attributes_search` returns the first `--per-page`
results. Walk pages 2+ only when the first page is thin; an
attribute that doesn't surface in the top 50 results almost
certainly doesn't exist.
## Ambiguous phrases
"email" is genuinely ambiguous (raw, sha256, md5, sha1, …). Don't
pick one silently when alternatives cluster within 1-2 ranking
points; surface the alternatives and let the user choose, or — if
`--no-confirm` — return `medium` confidence with a warning.
## Empty result is a legitimate answer
If walking all pages yields nothing, return the empty-result shape
from phase 5. Do not loop on more pages, do not invent an ID. The
caller will decide whether to author a custom attribute or refine.
## Custom attributes are not in scope
This skill finds Rosetta Stone attributes only. Custom attributes
(per-company, `custom.<name>`) need a different lookup path; if a
caller needs them, they should call `narrative_attributes_search`
directly with the custom namespace.
## Don't paraphrase the catalog
The user's downstream skill cares about the exact `attribute_id`
and `schema`. Return the describe payload's values verbatim — no
rewording display names, no rounding column types.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |