Skill Crossroads skills__ai-agents__advanced-agentdb-vector-search-implementation
rubric v1.2 · deterministic
F 59/100 overall
Correctness & Structure 33 2 fail
Triggering & Discoverability 33 2 fail
Clarity & Instructions 75 1 warn
Token & Context Cost 74 1 fail
Safety & Security 100 pass
Verifiability & Maintainability 53 1 fail

Top fixes — ranked by score impact

✗ STRUCT-01 Valid YAML frontmatter
SKILL.md:1— → YAML parser rejected the frontmatter block
Frontmatter failed to parse: Nested mappings are not allowed in compact mappings at line 2, column 14: description: Advanced AgentDB Vector Search Implementation operates on 3 fundam… ^
Fix Fix the YAML so it is a valid `key: value` mapping between the opening and closing `---` fences.
✗ STRUCT-02 Recommended fields present
SKILL.md:1
No frontmatter to read fields from (see STRUCT-01).
Fix Add frontmatter with a `description` field.
✗ TRIGGER-02 Description long enough to anchor invocation
SKILL.md:1
No description — nothing for the model to match against.
Fix Add a description that leads with the use case and the phrases a user would say.
✗ TRIGGER-03 Invocation cues in the description
SKILL.md:1
No description — no invocation cues possible.
Fix Add a description with explicit cues: 'Use when …' plus the phrases a user would say.
✗ TOKEN-01 Body under line/token budget
SKILL.md500-line guidance → 1168 lines
SKILL.md is 1168 lines — over the ~500-line guidance. ~11,812 tokens (rough est.); ~$0.0354 per load at $3/Mtok reference rate.
Fix Move heavy reference material into supporting files and link to them (progressive disclosure), keeping SKILL.md lean.
✗ VERIFY-01 Evals or tests present
SKILL.md:1the skill works → no evals/, tests/, or verification section found
No way to prove the skill does what it claims.
Fix Add an evals/ folder (test prompts + expected outcomes) and a '## Verify' step in the body.
⚠ TOKEN-04 Recurring per-invocation cost
SKILL.mda one-time authoring cost → ~11,812 tokens (rough est.) per invocation
Every invocation carries this: ~11,812 tokens (rough est.) per invocation — ~$35.44 per 1,000 invocations at the $3/Mtok reference rate.
Fix Cut the entry file below ~8k tokens — move reference material into supporting files so every future invocation gets cheaper.
⚠ CLARITY-03 No ASCII-art / persona filler
SKILL.md:906
Decorative ASCII-art / banner line — pure token cost, no instructional value.
echo "==================================="
Fix Delete decorative banners and persona filler; keep instructions plain and imperative.
★ scores higher than ≈0% of 208 public skills (deterministic rubric v1.2 sample, 2026-09)

Embed this badge

Skill Crossroads grade F Always-fresh — it re-scans and updates on its own. 
[![Skill Crossroads](https://skillcrossroads.com/api/badge/diegosouzapw/awesome-omni-skill/skills/ai-agents/advanced-agentdb-vector-search-implementation.svg)](https://skillcrossroads.com/s/diegosouzapw/awesome-omni-skill/skills/ai-agents/advanced-agentdb-vector-search-implementation)
Grade your own Claude Code skill — evidence-cited, file-and-line, free. Scan your own skill →