{"id":"2e13e557-c8df-4310-be81-d221a4ea2bd7","shortId":"PD77pA","kind":"skill","title":"validate-project-instructions","tagline":"Validate project-context AGENTS.md files for required sections, session-state model completeness, role quality, and scoring compliance.","description":"# Validate Project Context AGENTS\n\n## Purpose\nValidate project-context `AGENTS.md` files with structured checks for required sections, session-state controls, role definitions, and core required-section completeness based on a deterministic scoring rubric.\n\n## When To Use\n- Use this skill to validate project-context `AGENTS.md` files.\n- Use this skill when reviewing project context quality prior to active use.\n- Do not use this skill for user-context instruction validation.\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-project-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 project-context `AGENTS.md` path.\n- Expected section model and command reference expectations.\n- Any strictness preferences for warnings vs required fixes.\n\n## Workflow\n1. Run validation phases from `references/phase-checks.md`.\n2. Check for `<!-- spec_version: ... -->` comment: 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 project-specific remediation guidance.\n\n## Output Expectations\n- Structured markdown report with five validation phases.\n- Clear status for critical issues vs warnings.\n- Numeric score and grading band.\n- Concrete example fixes for major gaps.\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: `../../AGENTS.md`\n\n## Constraints And Safety\n- Keep findings specific and actionable.\n- Preserve project terminology when proposing fixes.\n- Keep validation language provider-neutral.\n- Do not rewrite source files automatically.","tags":["validate","project","instructions","context","kit","msiccdev","agent-skills","agents","ai-instructions","context-engineering","llm-context","llm-instructions"],"capabilities":["skill","source-msiccdev","skill-validate-project-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-project-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,227 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.500Z","embedding":null,"createdAt":"2026-05-18T13:22:21.612Z","updatedAt":"2026-05-18T19:14:30.500Z","lastSeenAt":"2026-05-18T19:14:30.500Z","tsv":"'/../agents.md':276 '/../readme.md':136 '1':171 '1.4.2':202 '2':177 '3':203 '4':208 '5':214 '6':220 'absent':185 'action':284 'activ':82,110 'add':128 'agent':27 'agents.md':9,33,70,153 'ai':107 'appli':209 'attach':100 'automat':302 'band':247,261 'base':53 'bucket':219 'chat':124 'check':37,178,266 'classifi':215 'claud':126 'clear':236 'code':122 'command':159 'comment':180 'complet':18,52 'complianc':23 'concret':248 'constraint':277 'content':104 'context':8,26,32,69,78,92,152 'contract':269 'control':44 'copilot':123 'core':48 'critic':239 'critical/warning/enhancement':218 'definit':46 'determinist':56,210 'exampl':249,274 'exist':188 'expect':155,161,228 'file':10,34,71,102,118,189,301 'find':216,281 'five':233 'fix':169,250,290 'flag':181,194 'follow':256,262 'full':144 'gap':253 'generat':204 'grade':246,260 'guidanc':146,226 'input':148 'instruct':4,93 'invok':97,134,138 'invoking-skil':137 'issu':240 'keep':280,291 'knowledg':132 'languag':293 'load':98 'major':252 'markdown':230 'may':190 'model':17,157,272 'neutral':296 'numer':243 'older':200 'output':227 'past':113 'path':154 'phase':174,235,265 'platform':145 'pre':187 'pre-exist':186 'predat':191 'prefer':164 'present':198 'preserv':285 'prior':80 'produc':221 'project':3,7,25,31,68,77,127,131,151,223,286 'project-context':6,30,67,150 'project-specif':222 'propos':289 'provid':295 'provider-neutr':294 'purpos':28 'qualiti':20,79 'readm':142 'refer':116,160 'references/phase-checks.md':176,267 'references/report-contract.md':207,257,270 'references/scoring.md':213,263,273 'remedi':225 'report':205,231,254,268 'requir':12,39,50,147,168,193 'required-sect':49 'resourc':264 'review':76 'rewrit':299 'role':19,45 'rubric':58 'run':172 'safeti':279 'schema':255 'score':22,57,211,244,258,271 'section':13,40,51,156 'see':133 'session':15,42,108 'session-st':14,41 'skill':64,74,88,135,139 'skill-validate-project-instructions' 'skills/validate-project-instructions/skill.md':119 'sourc':300 'source-msiccdev' 'specif':224,282 'state':16,43 'status':237 'strict':163 'structur':36,229 'target':149,275 'terminolog':287 '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':114 'use':61,62,72,83,86,206 'user':91 'user-context':90 'valid':2,5,24,29,66,94,173,234,292 'validate-project-instruct':1 'vs':121,167,241 'warn':166,183,196,242 'workflow':112,170","prices":[{"id":"e8adee9a-b9e1-493e-ac33-5038339a159e","listingId":"2e13e557-c8df-4310-be81-d221a4ea2bd7","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.612Z"}],"sources":[{"listingId":"2e13e557-c8df-4310-be81-d221a4ea2bd7","source":"github","sourceId":"MSiccDev/ai-context-kit/validate-project-instructions","sourceUrl":"https://github.com/MSiccDev/ai-context-kit/tree/development/skills/validate-project-instructions","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:21.612Z","lastSeenAt":"2026-05-18T19:14:30.500Z"}],"details":{"listingId":"2e13e557-c8df-4310-be81-d221a4ea2bd7","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MSiccDev","slug":"validate-project-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":"2c21c12bbdce34b97f33bf05e851d8780388af97","skill_md_path":"skills/validate-project-instructions/SKILL.md","default_branch":"development","skill_tree_url":"https://github.com/MSiccDev/ai-context-kit/tree/development/skills/validate-project-instructions"},"layout":"multi","source":"github","category":"ai-context-kit","frontmatter":{"name":"validate-project-instructions","description":"Validate project-context AGENTS.md files for required sections, session-state model completeness, role quality, and scoring compliance."},"skills_sh_url":"https://skills.sh/MSiccDev/ai-context-kit/validate-project-instructions"},"updatedAt":"2026-05-18T19:14:30.500Z"}}