{"id":"d48e7f2e-b6ec-4645-ada0-d852428ab172","shortId":"Yas3Cd","kind":"skill","title":"validate-agents-md","tagline":"Validate AGENTS.md files for structural completeness, operational contract coverage, neutrality, and repository alignment.","description":"# Validate AGENTS.md\n\n## Purpose\nValidate `AGENTS.md` files to ensure they are concise, operationally complete, and aligned with repository structure and governance.\n\n## When To Use\n- Use this skill when adding or updating root or nested `AGENTS.md` files.\n- Use this skill before accepting AGENTS policy changes.\n- Do not use this skill for user/project 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-agents-md/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 `AGENTS.md` path.\n- Repository path context for link/path validation.\n- Policy expectations for session-state and command namespace.\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. Provide concrete fixes for operational contract gaps.\n\n## Output Expectations\n- Structured markdown report with five validation phases.\n- Compliance score and pass band.\n- Explicit list of critical issues, warnings, and enhancements.\n- Example fixes for common structural and policy failures.\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 the scoring rubric deterministic; findings should be repository-specific and actionable.\n- Avoid over-prescriptive style-only feedback.\n- Preserve provider-neutral language.\n- Do not duplicate full normative specs when suggesting fixes.","tags":["validate","agents","context","kit","msiccdev","agent-skills","ai-instructions","context-engineering","instructions","llm-context","llm-instructions","project-context"],"capabilities":["skill","source-msiccdev","skill-validate-agents-md","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-agents-md","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,194 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.404Z","embedding":null,"createdAt":"2026-05-18T13:22:21.396Z","updatedAt":"2026-05-18T19:14:30.404Z","lastSeenAt":"2026-05-18T19:14:30.404Z","tsv":"'/../agents.md':252 '/../readme.md':111 '1':143 '1.4.2':174 '2':149 '3':175 '4':180 '5':186 '6':192 'absent':157 'accept':57 'action':268 'activ':85 'ad':45 'add':103 'agent':3,58 'agents.md':6,19,22,51,125 'ai':82 'align':17,32 'appli':181 'attach':75 'avoid':269 'band':213,237 'bucket':191 'chang':60 'chat':99 'check':150,242 'classifi':187 'claud':101 'code':97 'command':140 'comment':152 'common':225 'complet':10,30 'complianc':209 'concis':28 'concret':194 'constraint':253 'content':79 'context':129 'contract':12,198,245 'copilot':98 'coverag':13 'critic':217 'critical/warning/enhancement':190 'determinist':182,260 'duplic':284 'enhanc':221 'ensur':25 'exampl':222,250 'exist':160 'expect':134,201 'explicit':214 'failur':229 'feedback':276 'file':7,23,52,77,93,161 'find':188,261 'five':206 'fix':195,223,290 'flag':153,166 'follow':232,238 'full':119,285 'gap':199 'generat':176 'govern':37 'grade':236 'guidanc':121 'input':123 'instruct':68 'invok':72,109,113 'invoking-skil':112 'issu':218 'keep':256 'knowledg':107 'languag':281 'link/path':131 'list':215 'load':73 'markdown':203 'may':162 'md':4 'model':248 'namespac':141 'nest':50 'neutral':14,280 'normat':286 'older':172 'oper':11,29,197 'output':200 'over-prescript':270 'pass':212 'past':88 'path':126,128 'phase':146,208,241 'platform':120 'polici':59,133,228 'pre':159 'pre-exist':158 'predat':163 'prescript':272 'present':170 'preserv':277 'project':102,106 'provid':193,279 'provider-neutr':278 'purpos':20 'readm':117 'refer':91 'references/phase-checks.md':148,243 'references/report-contract.md':179,233,246 'references/scoring.md':185,239,249 'report':177,204,230,244 'repositori':16,34,127,265 'repository-specif':264 'requir':122,165 'resourc':240 'root':48 'rubric':259 'run':144 'safeti':255 'schema':231 'score':183,210,234,247,258 'see':108 'session':83,137 'session-st':136 'skill':43,55,65,110,114 'skill-validate-agents-md' 'skills/validate-agents-md/skill.md':94 'source-msiccdev' 'spec':287 'specif':266 'state':138 'structur':9,35,202,226 'style':274 'style-on':273 'suggest':289 'target':124,251 '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' 'updat':47 'upload':89 'use':40,41,53,63,178 'user/project':67 'valid':2,5,18,21,69,132,145,207 'validate-agents-md':1 'vs':96 'warn':155,168,219 'workflow':87,142","prices":[{"id":"30e15b9d-fb68-4266-bab9-ac810cd1eebe","listingId":"d48e7f2e-b6ec-4645-ada0-d852428ab172","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.396Z"}],"sources":[{"listingId":"d48e7f2e-b6ec-4645-ada0-d852428ab172","source":"github","sourceId":"MSiccDev/ai-context-kit/validate-agents-md","sourceUrl":"https://github.com/MSiccDev/ai-context-kit/tree/development/skills/validate-agents-md","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:21.396Z","lastSeenAt":"2026-05-18T19:14:30.404Z"}],"details":{"listingId":"d48e7f2e-b6ec-4645-ada0-d852428ab172","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MSiccDev","slug":"validate-agents-md","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":"f09729b85273cb03fab138befc052f0f8cd9409b","skill_md_path":"skills/validate-agents-md/SKILL.md","default_branch":"development","skill_tree_url":"https://github.com/MSiccDev/ai-context-kit/tree/development/skills/validate-agents-md"},"layout":"multi","source":"github","category":"ai-context-kit","frontmatter":{"name":"validate-agents-md","description":"Validate AGENTS.md files for structural completeness, operational contract coverage, neutrality, and repository alignment."},"skills_sh_url":"https://skills.sh/MSiccDev/ai-context-kit/validate-agents-md"},"updatedAt":"2026-05-18T19:14:30.404Z"}}