From 23890f9a2985223505c0bcc480656c986f9b5862 Mon Sep 17 00:00:00 2001 From: pratikwayase Date: Sun, 14 Jun 2026 22:30:08 +0530 Subject: [PATCH 1/2] docs: fix linting scripts README and instruction file gaps (#1107) --- .github/copilot-instructions.md | 2 ++ scripts/linting/README.md | 23 +++++++++++++++++++++++ 2 files changed, 25 insertions(+) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index eef55c4f6..d561d36c8 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -210,6 +210,8 @@ Agents should use npm scripts for all validation: * `npm run lint:py` - Python linting via ruff * `npm run lint:models` - Model reference validation against catalog * `npm run lint:models:refresh` - Refresh model catalog from upstream documentation +* `npm run lint:permissions` - File permission and mode validation +* `npm run lint:dependency-pinning` - Dependency pinning and SHA staleness validation * `npm run lint:all` - Run all linters (chains `format:tables`, `lint:md`, `lint:ps`, `lint:yaml`, `lint:links`, `lint:frontmatter`, `lint:collections-metadata`, `lint:marketplace`, `lint:version-consistency`, `lint:permissions`, `lint:dependency-pinning`, `lint:py`, `validate:skills`, `lint:ai-artifacts`, and `lint:models`) * `npm run validate:copyright` - Copyright header validation * `npm run validate:skills` - Skill structure validation diff --git a/scripts/linting/README.md b/scripts/linting/README.md index d057ce4c1..e0c7ed45e 100644 --- a/scripts/linting/README.md +++ b/scripts/linting/README.md @@ -631,6 +631,29 @@ Markdown link checker configuration. * Timeout: 10 seconds * Ignore patterns: Localhost, example.com +## Schemas Directory + +The `schemas/` directory contains JSON schema files used for frontmatter validation. These schemas ensure that the metadata in various markdown and configuration files adheres to the expected structure. + +### Schema Files + +The directory includes the following 10 JSON schema files: + +* `agent-frontmatter.schema.json` +* `base-frontmatter.schema.json` +* `chatmode-frontmatter.schema.json` +* `collection-manifest.schema.json` +* `docs-frontmatter.schema.json` +* `instruction-frontmatter.schema.json` +* `marketplace-manifest.schema.json` +* `prompt-frontmatter.schema.json` +* `root-community-frontmatter.schema.json` +* `skill-frontmatter.schema.json` + +### Schema Mapping + +* `schema-mapping.json`: Maps glob patterns to their corresponding JSON schemas for targeted validation. + ## Testing All scripts support local testing before running in GitHub Actions: From 1a9d32f25a3a226d751ea03b142a622e2d5bf1fe Mon Sep 17 00:00:00 2001 From: pratikwayase Date: Tue, 16 Jun 2026 16:16:19 +0530 Subject: [PATCH 2/2] docs: update schema count to 19 in linting README --- .github/copilot-instructions.md | 2 +- scripts/linting/README.md | 9 +++++++++ 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index d561d36c8..20cb9d22e 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -210,7 +210,7 @@ Agents should use npm scripts for all validation: * `npm run lint:py` - Python linting via ruff * `npm run lint:models` - Model reference validation against catalog * `npm run lint:models:refresh` - Refresh model catalog from upstream documentation -* `npm run lint:permissions` - File permission and mode validation +* `npm run lint:permissions` - Workflow permissions validation * `npm run lint:dependency-pinning` - Dependency pinning and SHA staleness validation * `npm run lint:all` - Run all linters (chains `format:tables`, `lint:md`, `lint:ps`, `lint:yaml`, `lint:links`, `lint:frontmatter`, `lint:collections-metadata`, `lint:marketplace`, `lint:version-consistency`, `lint:permissions`, `lint:dependency-pinning`, `lint:py`, `validate:skills`, `lint:ai-artifacts`, and `lint:models`) * `npm run validate:copyright` - Copyright header validation diff --git a/scripts/linting/README.md b/scripts/linting/README.md index e0c7ed45e..0633a5a92 100644 --- a/scripts/linting/README.md +++ b/scripts/linting/README.md @@ -649,6 +649,15 @@ The directory includes the following 10 JSON schema files: * `prompt-frontmatter.schema.json` * `root-community-frontmatter.schema.json` * `skill-frontmatter.schema.json` +* `accessibility-state.schema.json` +* `adr-config.schema.json` +* `adr-consistency-rules.schema.json` +* `adr-frontmatter.schema.json` +* `ai-artifact-config.schema.json` +* `model-catalog.schema.json` +* `rai-state.schema.json` +* `security-state.schema.json` +* `sssc-state.schema.json` ### Schema Mapping