{"id":"514eafa1-7ac1-4c7a-aaf3-2000344b8407","shortId":"rXKYCC","kind":"skill","title":"validate-usercontext-instructions","tagline":"Validate user-context instruction files against schema, section completeness, quality checks, and scoring criteria.","description":"# Validate User Context Instructions\n\n## Purpose\nValidate user-context instruction files and produce structured reports with issues, recommendations, and a compliance score based on a deterministic scoring rubric.\n\n## When To Use\n- Use this skill to validate `*_usercontext.instructions.md` files.\n- Use this skill before publishing or reusing a user-context file.\n- Do not use this skill for project `AGENTS.md` (project context) files.\n\n## How to Invoke\n\nLoad or attach this file's contents into your AI session to activate the workflow (paste, upload, or reference with `#file:skills/validate-usercontext-instructions/SKILL.md` in VS Code Copilot Chat). In Claude Projects, add it to project knowledge. See [Invoking Skills](../../README.md#invoking-skills) in the README for full platform guidance.\n\n## Required Inputs\n- Target file path.\n- Expected spec version and required sections.\n- Validation strictness expectations (if any).\n\n## Workflow\n1. Run validation phases from `references/phase-checks.md`.\n2. Check for `spec_version` field in YAML frontmatter: flag as WARNING if absent (pre-existing files may predate this requirement); flag as WARNING if present but older than `1.4.2`.\n3. Generate report using `references/report-contract.md`.\n4. Apply deterministic scoring from `references/scoring.md`.\n5. Classify findings into critical/warning/enhancement buckets.\n6. Produce implementation-ready recommendations.\n\n## Output Expectations\n- A markdown validation report with phase-by-phase findings.\n- Overall PASS/WARN/FAIL state and numeric score.\n- Actionable fixes for critical and warning issues.\n- Migration guidance when relevant.\n- Report schema follows `references/report-contract.md`.\n- Scoring and grade bands follow `references/scoring.md`.\n\n## Resources\n- Phase checks: `references/phase-checks.md`\n- Report contract: `references/report-contract.md`\n- Scoring model: `references/scoring.md`\n- Example target: `../../usercontexts/sample_usercontext.instructions.md`\n- Example report: `../../usercontexts/sample_usercontext.validation.md`\n\n## Constraints And Safety\n- Preserve privacy boundaries in findings and examples.\n- Keep recommendations implementation-ready and non-ambiguous.\n- Use provider-neutral language.\n- Do not modify validated source files automatically.","tags":["validate","usercontext","instructions","context","kit","msiccdev","agent-skills","agents","ai-instructions","context-engineering","llm-context","llm-instructions"],"capabilities":["skill","source-msiccdev","skill-validate-usercontext-instructions","topic-agent-skills","topic-agents","topic-ai-instructions","topic-context","topic-context-engineering","topic-instructions","topic-llm-context","topic-llm-instructions","topic-project-context","topic-user-context"],"categories":["ai-context-kit"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/MSiccDev/ai-context-kit/validate-usercontext-instructions","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add MSiccDev/ai-context-kit","source_repo":"https://github.com/MSiccDev/ai-context-kit","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 6 github stars · SKILL.md body (2,292 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:30.685Z","embedding":null,"createdAt":"2026-05-18T13:22:21.876Z","updatedAt":"2026-05-18T19:14:30.685Z","lastSeenAt":"2026-05-18T19:14:30.685Z","tsv":"'/../readme.md':122 '/../usercontexts/sample_usercontext.instructions.md':261 '/../usercontexts/sample_usercontext.validation.md':264 '1':150 '1.4.2':186 '2':156 '3':187 '4':192 '5':198 '6':204 'absent':169 'action':228 'activ':96 'add':114 'agents.md':77 'ai':93 'ambigu':283 'appli':193 'attach':86 'automat':295 'band':246 'base':42 'boundari':270 'bucket':203 'chat':110 'check':16,157,251 'classifi':199 'claud':112 'code':108 'complet':14 'complianc':40 'constraint':265 'content':90 'context':8,22,28,68,79 'contract':254 'copilot':109 'criteria':19 'critic':231 'critical/warning/enhancement':202 'determinist':45,194 'exampl':259,262,274 'exist':172 'expect':138,146,211 'field':161 'file':10,30,57,69,80,88,104,136,173,294 'find':200,221,272 'fix':229 'flag':165,178 'follow':241,247 'frontmatt':164 'full':130 'generat':188 'grade':245 'guidanc':132,236 'implement':207,278 'implementation-readi':206,277 'input':134 'instruct':4,9,23,29 'invok':83,120,124 'invoking-skil':123 'issu':36,234 'keep':275 'knowledg':118 'languag':288 'load':84 'markdown':213 'may':174 'migrat':235 'model':257 'modifi':291 'neutral':287 'non':282 'non-ambigu':281 'numer':226 'older':184 'output':210 'overal':222 'pass/warn/fail':223 'past':99 'path':137 'phase':153,218,220,250 'phase-by-phas':217 'platform':131 'pre':171 'pre-exist':170 'predat':175 'present':182 'preserv':268 'privaci':269 'produc':32,205 'project':76,78,113,117 'provid':286 'provider-neutr':285 'publish':62 'purpos':24 'qualiti':15 'readi':208,279 'readm':128 'recommend':37,209,276 'refer':102 'references/phase-checks.md':155,252 'references/report-contract.md':191,242,255 'references/scoring.md':197,248,258 'relev':238 'report':34,189,215,239,253,263 'requir':133,142,177 'resourc':249 'reus':64 'rubric':47 'run':151 'safeti':267 'schema':12,240 'score':18,41,46,195,227,243,256 'section':13,143 'see':119 'session':94 'skill':53,60,74,121,125 'skill-validate-usercontext-instructions' 'skills/validate-usercontext-instructions/skill.md':105 'sourc':293 'source-msiccdev' 'spec':139,159 'state':224 'strict':145 'structur':33 'target':135,260 'topic-agent-skills' 'topic-agents' 'topic-ai-instructions' 'topic-context' 'topic-context-engineering' 'topic-instructions' 'topic-llm-context' 'topic-llm-instructions' 'topic-project-context' 'topic-user-context' 'upload':100 'use':50,51,58,72,190,284 'user':7,21,27,67 'user-context':6,26,66 'usercontext':3 'usercontext.instructions.md':56 'valid':2,5,20,25,55,144,152,214,292 'validate-usercontext-instruct':1 'version':140,160 'vs':107 'warn':167,180,233 'workflow':98,149 'yaml':163","prices":[{"id":"9ece30ac-224d-42e6-a7dc-62ffd45aadaa","listingId":"514eafa1-7ac1-4c7a-aaf3-2000344b8407","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"MSiccDev","category":"ai-context-kit","install_from":"skills.sh"},"createdAt":"2026-05-18T13:22:21.876Z"}],"sources":[{"listingId":"514eafa1-7ac1-4c7a-aaf3-2000344b8407","source":"github","sourceId":"MSiccDev/ai-context-kit/validate-usercontext-instructions","sourceUrl":"https://github.com/MSiccDev/ai-context-kit/tree/development/skills/validate-usercontext-instructions","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:21.876Z","lastSeenAt":"2026-05-18T19:14:30.685Z"}],"details":{"listingId":"514eafa1-7ac1-4c7a-aaf3-2000344b8407","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MSiccDev","slug":"validate-usercontext-instructions","github":{"repo":"MSiccDev/ai-context-kit","stars":6,"topics":["agent-skills","agents","ai","ai-instructions","context","context-engineering","instructions","llm-context","llm-instructions","project-context","user-context"],"license":"mit","html_url":"https://github.com/MSiccDev/ai-context-kit","pushed_at":"2026-05-12T06:56:19Z","description":"AI Context Kit provides a structured, instruction-based framework for context-aware AI collaboration across LLM providers. It includes authoritative specs, canonical templates, and skills workflows for creating and validating user context and project AGENTS.md files.","skill_md_sha":"86c2a8586281f45dcff8eb40c0e5a1ffb1b4219b","skill_md_path":"skills/validate-usercontext-instructions/SKILL.md","default_branch":"development","skill_tree_url":"https://github.com/MSiccDev/ai-context-kit/tree/development/skills/validate-usercontext-instructions"},"layout":"multi","source":"github","category":"ai-context-kit","frontmatter":{"name":"validate-usercontext-instructions","description":"Validate user-context instruction files against schema, section completeness, quality checks, and scoring criteria."},"skills_sh_url":"https://skills.sh/MSiccDev/ai-context-kit/validate-usercontext-instructions"},"updatedAt":"2026-05-18T19:14:30.685Z"}}