{"slug":"skyzh-write-you-a-vector-db","name":"Write You A Vector Db","description":"A Vector Database Tutorial (over CMU-DB's BusTub system)","tagline":"A Vector Database Tutorial (over CMU-DB's BusTub system)","category":"rag-knowledge","tags":["vector-database","retrieval","knowledge","bustub","database","tutorial","c++","github"],"author":{"name":"skyzh","verified":false,"url":"https://github.com/skyzh"},"attribution":{"status":"community_indexed","statusLabel":"Community indexed","shortLabel":"COMMUNITY INDEXED","sourceLabel":"GitHub star discovery","sourceDetail":"skyzh/write-you-a-vector-db","creatorName":"skyzh","creatorUrl":"https://github.com/skyzh","sourceUrl":"https://github.com/skyzh/write-you-a-vector-db","indexedBy":"OpenAgentSkill community index","claimUrl":"https://www.openagentskill.com/skills/skyzh-write-you-a-vector-db#claim-this-skill","claimCta":"Claim this skill","trustNote":"This listing was indexed from public sources and is not marked official until a maintainer claim is approved.","publicNote":"Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals."},"stats":{"stars":759,"forks":22,"verified_installs":0,"install_attempts":0,"successful_runs":0,"total_outcomes":0,"downloads":0,"rating":0,"review_count":0,"quality_score":38.87},"quality":{"score":50,"tier":"review","label":"Needs review","summary":"Inspect the repository carefully before adding it to an agent workflow.","signals":[{"label":"GitHub stars","value":"759","tone":"positive"},{"label":"Freshness","value":"2y ago","tone":"warning"},{"label":"Install ready","value":"Yes","tone":"positive"},{"label":"License","value":"Unknown","tone":"neutral"}],"warnings":["Repository looks stale"]},"trust":{"version":"trust-score-v4","score":70,"tier":"review","label":"Manual review","summary":"Potentially useful, but at least one trust signal needs human inspection.","recommendedAction":"Inspect the repository, license, and recent activity before connecting it to agent workflows.","dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":76,"weight":0.13,"status":"info","detail":"759 GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":65,"weight":0.08,"status":"info","detail":"759 stars, 22 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":38,"weight":0.14,"status":"fail","detail":"2y since push"},{"id":"license","label":"License clarity","score":42,"weight":0.09,"status":"warn","detail":"Unknown"},{"id":"documentation","label":"README/SKILL.md completeness","score":74,"weight":0.14,"status":"info","detail":"Public metadata needs stronger README/SKILL.md context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":82,"weight":0.12,"status":"pass","detail":"database surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add skyzh/write-you-a-vector-db"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":74,"weight":0.07,"status":"info","detail":"filesystem or document access, database access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/skyzh/write-you-a-vector-db"},{"id":"review_status","label":"Review status","score":88,"weight":0.05,"status":"pass","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"info","label":"GitHub adoption","detail":"759 GitHub stars"},{"status":"info","label":"Stars/forks activity","detail":"759 stars, 22 forks; issue activity unavailable in current metadata"},{"status":"fail","label":"Recent maintenance","detail":"2y since push"},{"status":"warn","label":"License clarity","detail":"Unknown"},{"status":"info","label":"README/SKILL.md completeness","detail":"Public metadata needs stronger README/SKILL.md context"},{"status":"pass","label":"Dependency/runtime risk","detail":"database surface"},{"status":"pass","label":"Install availability","detail":"npx skills add skyzh/write-you-a-vector-db"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"info","label":"Permission surface","detail":"filesystem or document access, database access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/skyzh/write-you-a-vector-db"},{"status":"pass","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Meaningful GitHub adoption signal","Install command has no obvious high-risk pattern"],"warnings":["Financial research output is not financial advice; require human review before any live investment decision.","License is unclear","Repository looks stale","Quality score needs review","Recent maintenance: 2y since push","License clarity: Unknown"],"evidence":{"stars":"759 GitHub stars","repoActivity":"759 stars, 22 forks","lastPushed":"2y since push","license":"Unknown","repository":"https://github.com/skyzh/write-you-a-vector-db","install":"npx skills add skyzh/write-you-a-vector-db","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, database access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet"},"installReadiness":{"ready":true,"command":"npx skills add skyzh/write-you-a-vector-db","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is unclear","No Agent Proven outcome evidence yet","2y since push","Financial domain: human review is required before use in a live investment workflow."]},"agentCompatibility":["C++","Vector Search","Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["Financial research output is not financial advice; require human review before any live investment decision.","License is unclear","Repository looks stale","Quality score needs review","Recent maintenance: 2y since push"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Human review or sandbox validation is required before automatic installation."},"bestFor":["rag-knowledge","vector-database","retrieval","knowledge","bustub","database"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Commercial reuse before clarifying license terms","Autonomous investment, trading, tax, or suitability decisions without a qualified human review"],"knownRisks":["Financial research output is not financial advice; require human review before any live investment decision.","License is unclear","Repository looks stale","Quality score needs review","Recent maintenance: 2y since push","License clarity: Unknown"]},"safety":{"score":44,"level":"avoid_auto_install","label":"Avoid automatic install","safety_tier":{"tier":"experimental","label":"Experimental","badge":"EXPERIMENTAL","summary":"Sparse or mixed signals. Useful for discovery, but not for autonomous installation.","recommended_action":"Test manually in an isolated workspace and compare against safer alternatives.","auto_install_policy":"review","reasons":["License is unclear","44/100 agent safety score"]},"auto_install_allowed":false,"human_review_required":true,"blocked":false,"audit_risk":"needs_review","permission_hints":[{"id":"network","label":"Network access","reason":"Skill likely fetches remote pages, APIs, repositories, or external services.","severity":"medium"},{"id":"filesystem","label":"Filesystem access","reason":"Skill may read or write project files, documents, generated artifacts, or local workspace state.","severity":"medium"},{"id":"database","label":"Database access","reason":"Skill may inspect schemas, query databases, or work with persistent stores.","severity":"medium"}],"policy_warnings":["License is unclear"],"constraints_applied":{"max_risk":"medium","needs_install_command":true,"min_stars":0}},"safety_gate":{"tier":"experimental","label":"Experimental","badge":"EXPERIMENTAL","auto_install_policy":"review","auto_install_allowed":false,"human_review_required":true,"blocked":false,"recommended_action":"Test manually in an isolated workspace and compare against safer alternatives.","reasons":["License is unclear","44/100 agent safety score"]},"supply_profile":{"track":{"slug":"research","label":"Research and knowledge work","shortLabel":"Research","description":"Deep research, source comparison, literature review, RAG, knowledge search, and reports."},"scenario":{"label":"RAG and knowledge","description":"I need my agent to build a RAG workflow over documents and retrieve reliable context.","useCases":[{"slug":"rag-knowledge","title":"RAG and knowledge"},{"slug":"coding-agents","title":"Coding agents"},{"slug":"workflow-automation","title":"Workflow automation"}]},"applicableAgents":["Claude Code","CLI","Codex","Cursor","C++"],"install":{"ready":true,"command":"npx skills add skyzh/write-you-a-vector-db","primaryTarget":"CLI","targetCount":4},"githubQuality":{"stars":759,"starsLabel":"759","forks":22,"license":"Unknown","qualityScore":50,"trustScore":70,"auditScore":64},"maintenance":{"status":"stale","label":"2y since push","daysSincePush":580,"lastPushedAt":"2025-01-19T23:10:36+00:00"},"risk":{"level":"needs_review","label":"Needs review","requiresReview":true,"notes":["License is unclear","Repository appears stale","Financial research output is not financial advice; require human review before any live investment decision","Repository looks stale","Financial research output is not financial advice; require human review before any live investment decision."]},"coverageTags":["Research","RAG and knowledge","rag-knowledge","vector-database","retrieval","knowledge","bustub","database"]},"audit":{"audit_score":64,"risk_level":"needs_review","risk_label":"Needs review","warnings":["License is unclear","Repository appears stale","Financial research output is not financial advice; require human review before any live investment decision","Repository looks stale","Financial research output is not financial advice; require human review before any live investment decision."]},"decision":{"readiness_score":52,"readiness_label":"Needs manual review","headline":"Needs validation for RAG and knowledge","role":"Needs validation","primary_fit":"RAG and knowledge","best_for":["RAG and knowledge workflows","Claude Code teams","teams that value GitHub adoption signals"],"risks":["Repository looks stale","No OpenAgentSkill engagement data yet"],"next_steps":["Install it in a sandbox agent and run one RAG and knowledge task end to end.","Compare output quality, latency, and failure behavior against at least one alternative.","Promote it into production only after reviewing repository permissions, license, and maintenance signals."]},"agent_readable_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"skyzh-write-you-a-vector-db","name":"Write You A Vector Db","description":"A Vector Database Tutorial (over CMU-DB's BusTub system)","category":"rag-knowledge","url":"https://www.openagentskill.com/skills/skyzh-write-you-a-vector-db","repository":"https://github.com/skyzh/write-you-a-vector-db","github_repo":"skyzh/write-you-a-vector-db"},"suited_tasks":["RAG and knowledge workflows","Claude Code teams","teams that value GitHub adoption signals","Chunk documents","Create embeddings","Retrieve and cite relevant passages","Inspect source files","Explain architecture"],"suited_agents":["C++","Vector Search","Codex","Claude Code","Cursor","OpenAgentSkill CLI","CLI"],"install":{"command":"npx skills add skyzh/write-you-a-vector-db","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install skyzh-write-you-a-vector-db"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"Write You A Vector Db\" agent skill from https://github.com/skyzh/write-you-a-vector-db. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: A Vector Database Tutorial (over CMU-DB's BusTub system) After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"skyzh-write-you-a-vector-db\",\"task\":\"Install Write You A Vector Db\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"Write You A Vector Db\" as a Claude Code skill from https://github.com/skyzh/write-you-a-vector-db. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: A Vector Database Tutorial (over CMU-DB's BusTub system) After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"skyzh-write-you-a-vector-db\",\"task\":\"Install Write You A Vector Db\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"Write You A Vector Db\" from https://github.com/skyzh/write-you-a-vector-db into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: A Vector Database Tutorial (over CMU-DB's BusTub system) After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"skyzh-write-you-a-vector-db\",\"task\":\"Install Write You A Vector Db\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."}],"handoff_url":"https://www.openagentskill.com/api/skills/skyzh-write-you-a-vector-db/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/skyzh-write-you-a-vector-db"},"trust":{"score":70,"label":"Manual review","version":"trust-score-v4","install_policy":"human_review_before_install","evidence":{"stars":"759 GitHub stars","repoActivity":"759 stars, 22 forks","lastPushed":"2y since push","license":"Unknown","repository":"https://github.com/skyzh/write-you-a-vector-db","install":"npx skills add skyzh/write-you-a-vector-db","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, database access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["rag-knowledge","vector-database","retrieval","knowledge","bustub","database"],"known_risks":["Financial research output is not financial advice; require human review before any live investment decision.","License is unclear","Repository looks stale","Quality score needs review","Recent maintenance: 2y since push","License clarity: Unknown"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":64,"risk_level":"needs_review","risk_label":"Needs review","warnings":["License is unclear","Repository appears stale","Financial research output is not financial advice; require human review before any live investment decision","Repository looks stale","Financial research output is not financial advice; require human review before any live investment decision.","Quality score needs review","Recent maintenance: 2y since push","License clarity: Unknown"]},"safety_gate":{"tier":"experimental","label":"Experimental","auto_install_policy":"review","auto_install_allowed":false,"human_review_required":true,"blocked":false,"recommended_action":"Test manually in an isolated workspace and compare against safer alternatives."},"quality":{"score":50,"label":"Needs review"},"supply":{"track":"Research and knowledge work","scenario":"RAG and knowledge","maintenance":"2y since push","risk":"Needs review"},"alternative_skills":[],"do_not_use_when":["teams that require actively maintained dependencies","production agents without a repository review","Repository looks stale","No OpenAgentSkill engagement data yet","License is unclear","Repository appears stale","Financial research output is not financial advice; require human review before any live investment decision","Financial research output is not financial advice; require human review before any live investment decision."],"agent_contract":{"task_input":"Use Write You A Vector Db in an agent workflow","recommended_action":"Test manually in an isolated workspace and compare against safer alternatives.","install_policy":"review","minimum_review_before_use":["Trust: 70/100 Manual review","Audit: 64/100 Needs review","Safety: 44/100 Avoid automatic install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"skyzh-write-you-a-vector-db (Write You A Vector Db)","install_command":"npx skills add skyzh/write-you-a-vector-db","risk_summary":"Needs review; Experimental; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"<install_receipt.outcome_feedback.event_id or feedback.event_id from /api/agent/resolve>","skill_slug":"skyzh-write-you-a-vector-db","task":"Use Write You A Vector Db in an agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/skyzh-write-you-a-vector-db","api":"https://www.openagentskill.com/api/agent/skills/skyzh-write-you-a-vector-db","audit":"https://www.openagentskill.com/skills/skyzh-write-you-a-vector-db/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=skyzh-write-you-a-vector-db&task=Use%20Write%20You%20A%20Vector%20Db%20in%20an%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Use%20Write%20You%20A%20Vector%20Db%20in%20an%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Use%20Write%20You%20A%20Vector%20Db%20in%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/skyzh-write-you-a-vector-db/install","manifest":"https://www.openagentskill.com/api/registry/manifest/skyzh-write-you-a-vector-db"}},"machine_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"skyzh-write-you-a-vector-db","name":"Write You A Vector Db","description":"A Vector Database Tutorial (over CMU-DB's BusTub system)","category":"rag-knowledge","url":"https://www.openagentskill.com/skills/skyzh-write-you-a-vector-db","repository":"https://github.com/skyzh/write-you-a-vector-db","github_repo":"skyzh/write-you-a-vector-db"},"suited_tasks":["RAG and knowledge workflows","Claude Code teams","teams that value GitHub adoption signals","Chunk documents","Create embeddings","Retrieve and cite relevant passages","Inspect source files","Explain architecture"],"suited_agents":["C++","Vector Search","Codex","Claude Code","Cursor","OpenAgentSkill CLI","CLI"],"install":{"command":"npx skills add skyzh/write-you-a-vector-db","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install skyzh-write-you-a-vector-db"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"Write You A Vector Db\" agent skill from https://github.com/skyzh/write-you-a-vector-db. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: A Vector Database Tutorial (over CMU-DB's BusTub system) After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"skyzh-write-you-a-vector-db\",\"task\":\"Install Write You A Vector Db\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"Write You A Vector Db\" as a Claude Code skill from https://github.com/skyzh/write-you-a-vector-db. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: A Vector Database Tutorial (over CMU-DB's BusTub system) After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"skyzh-write-you-a-vector-db\",\"task\":\"Install Write You A Vector Db\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"Write You A Vector Db\" from https://github.com/skyzh/write-you-a-vector-db into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: A Vector Database Tutorial (over CMU-DB's BusTub system) After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"skyzh-write-you-a-vector-db\",\"task\":\"Install Write You A Vector Db\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."}],"handoff_url":"https://www.openagentskill.com/api/skills/skyzh-write-you-a-vector-db/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/skyzh-write-you-a-vector-db"},"trust":{"score":70,"label":"Manual review","version":"trust-score-v4","install_policy":"human_review_before_install","evidence":{"stars":"759 GitHub stars","repoActivity":"759 stars, 22 forks","lastPushed":"2y since push","license":"Unknown","repository":"https://github.com/skyzh/write-you-a-vector-db","install":"npx skills add skyzh/write-you-a-vector-db","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, database access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["rag-knowledge","vector-database","retrieval","knowledge","bustub","database"],"known_risks":["Financial research output is not financial advice; require human review before any live investment decision.","License is unclear","Repository looks stale","Quality score needs review","Recent maintenance: 2y since push","License clarity: Unknown"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":64,"risk_level":"needs_review","risk_label":"Needs review","warnings":["License is unclear","Repository appears stale","Financial research output is not financial advice; require human review before any live investment decision","Repository looks stale","Financial research output is not financial advice; require human review before any live investment decision.","Quality score needs review","Recent maintenance: 2y since push","License clarity: Unknown"]},"safety_gate":{"tier":"experimental","label":"Experimental","auto_install_policy":"review","auto_install_allowed":false,"human_review_required":true,"blocked":false,"recommended_action":"Test manually in an isolated workspace and compare against safer alternatives."},"quality":{"score":50,"label":"Needs review"},"supply":{"track":"Research and knowledge work","scenario":"RAG and knowledge","maintenance":"2y since push","risk":"Needs review"},"alternative_skills":[],"do_not_use_when":["teams that require actively maintained dependencies","production agents without a repository review","Repository looks stale","No OpenAgentSkill engagement data yet","License is unclear","Repository appears stale","Financial research output is not financial advice; require human review before any live investment decision","Financial research output is not financial advice; require human review before any live investment decision."],"agent_contract":{"task_input":"Use Write You A Vector Db in an agent workflow","recommended_action":"Test manually in an isolated workspace and compare against safer alternatives.","install_policy":"review","minimum_review_before_use":["Trust: 70/100 Manual review","Audit: 64/100 Needs review","Safety: 44/100 Avoid automatic install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"skyzh-write-you-a-vector-db (Write You A Vector Db)","install_command":"npx skills add skyzh/write-you-a-vector-db","risk_summary":"Needs review; Experimental; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"<install_receipt.outcome_feedback.event_id or feedback.event_id from /api/agent/resolve>","skill_slug":"skyzh-write-you-a-vector-db","task":"Use Write You A Vector Db in an agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/skyzh-write-you-a-vector-db","api":"https://www.openagentskill.com/api/agent/skills/skyzh-write-you-a-vector-db","audit":"https://www.openagentskill.com/skills/skyzh-write-you-a-vector-db/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=skyzh-write-you-a-vector-db&task=Use%20Write%20You%20A%20Vector%20Db%20in%20an%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Use%20Write%20You%20A%20Vector%20Db%20in%20an%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Use%20Write%20You%20A%20Vector%20Db%20in%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/skyzh-write-you-a-vector-db/install","manifest":"https://www.openagentskill.com/api/registry/manifest/skyzh-write-you-a-vector-db"}},"platforms":["C++","Vector Search","Claude Code"],"use_cases":[{"slug":"rag-knowledge","title":"RAG and knowledge","url":"https://www.openagentskill.com/use-cases/rag-knowledge"},{"slug":"coding-agents","title":"Coding agents","url":"https://www.openagentskill.com/use-cases/coding-agents"},{"slug":"workflow-automation","title":"Workflow automation","url":"https://www.openagentskill.com/use-cases/workflow-automation"},{"slug":"sports-analytics","title":"Sports analytics","url":"https://www.openagentskill.com/use-cases/sports-analytics"}],"install":"npx skills add skyzh/write-you-a-vector-db","install_targets":[{"id":"openagentskill-cli","label":"CLI","title":"OpenAgentSkill CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install skyzh-write-you-a-vector-db","description":"Resolve policy, run the source installer safely, and report a verified install receipt.","copyLabel":"Copy command"},{"id":"codex","label":"Codex","title":"Codex install prompt","kind":"agent-prompt","value":"Install the \"Write You A Vector Db\" agent skill from https://github.com/skyzh/write-you-a-vector-db. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: A Vector Database Tutorial (over CMU-DB's BusTub system) After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"skyzh-write-you-a-vector-db\",\"task\":\"Install Write You A Vector Db\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Give Codex a repo-aware install prompt when the skill is not available through a local CLI.","copyLabel":"Copy prompt"},{"id":"claude-code","label":"Claude Code","title":"Claude Code skill prompt","kind":"agent-prompt","value":"Add \"Write You A Vector Db\" as a Claude Code skill from https://github.com/skyzh/write-you-a-vector-db. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: A Vector Database Tutorial (over CMU-DB's BusTub system) After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"skyzh-write-you-a-vector-db\",\"task\":\"Install Write You A Vector Db\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Use this prompt to ask Claude Code to add the skill and explain the local activation steps.","copyLabel":"Copy prompt"},{"id":"cursor","label":"Cursor","title":"Cursor rule prompt","kind":"agent-prompt","value":"Turn \"Write You A Vector Db\" from https://github.com/skyzh/write-you-a-vector-db into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: A Vector Database Tutorial (over CMU-DB's BusTub system) After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"skyzh-write-you-a-vector-db\",\"task\":\"Install Write You A Vector Db\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Use this when installing as Cursor project rules or reusable agent instructions.","copyLabel":"Copy prompt"}],"repository":"https://github.com/skyzh/write-you-a-vector-db","github_repo":"skyzh/write-you-a-vector-db","version":"1.0.0","license":"Unknown","updated_at":"2026-08-18T17:22:21.819119+00:00","canonical_key":"skyzh/write-you-a-vector-db","recommendation_reasons":["Useful GitHub adoption: 759 stars","Install handoff is available","Repository freshness signal is available"],"urls":{"web":"https://www.openagentskill.com/skills/skyzh-write-you-a-vector-db","api":"https://www.openagentskill.com/api/agent/skills/skyzh-write-you-a-vector-db","install_api":"https://www.openagentskill.com/api/skills/skyzh-write-you-a-vector-db/install","audit":"https://www.openagentskill.com/skills/skyzh-write-you-a-vector-db/audit","repository":"https://github.com/skyzh/write-you-a-vector-db"},"meta":{"endpoint":"/api/registry/manifest/{slug}","canonical_agent_endpoint":"/api/agent/skills/skyzh-write-you-a-vector-db","agent_friendly":true,"api_version":"1.0","generated_at":"2026-08-23T06:00:05.680Z"}}