[skill-freshness] chore: skill freshness update 2025-07-14 (docs-syntax-help, docs-validate-code-samples)

[github-actions]

Caution

Protected files were modified in this change.
This pull request is in request_review mode and requires explicit human scrutiny before merge.

Protected files: .claude-plugin/plugin.json

Skill freshness update — 2025-07-14

Skills checked

• docs-syntax-help: stale
• docs-validate-code-samples: stale
• fix-changelog: current
• review-changelog: current
• kibana-release-notes: current
• serverless-changelog: current
• applies-to-tagging: current
• page-opening-optimizer: current
• frontmatter-description: current
• docs-redirects: current
• lens-chart-page: current
• lens-chart-settings: current
• content-type-checker: current
• frontmatter-audit: current
• skill-review: current
• docs-check-style: current
• flag-jargon-skill: skipped (no sources)

Changes made

docs-syntax-help (1.0.7 → 1.0.8)

• What drifted: The upstream substitutions reference now documents four additional text-case operators (c, sc, cc, pc) and three additional version format operators (M, M.x, M.M+1) that were absent from the skill.
• What was updated: Added c (capitalize first letter), sc (snake_case), cc (camelCase), pc (PascalCase) to the pipe-operator list; added M (major only), M.x (major.x), and M.M+1 (next minor) to the version operators list.
• Source: Substitutions reference

docs-validate-code-samples (1.0.1 → 1.0.2)

• What drifted: The upstream ES|QL processing-commands page added several new commands. Additionally, MATCH and QSTR in G-2 are WHERE-compatible functions, not standalone pipe commands — the old skill would wrongly accept | MATCH(...) as valid ES|QL. LOOKUP should be LOOKUP JOIN.
• What was updated:
  • Added new GA commands: COMPLETION (9.3), METRICS_INFO (9.4), TS_INFO (9.4)
  • Added new preview commands: FUSE, MMR, REGISTERED_DOMAIN, TS_COLLAPSE, USER_AGENT, URI_PARTS
  • Renamed LOOKUP → LOOKUP JOIN (correct upstream command name)
  • Removed MATCH and QSTR from the pipe-command allowlist (functions used inside WHERE, not standalone pipe commands)
• Source: ES|QL processing commands

No changes needed

fix-changelog, review-changelog, kibana-release-notes, serverless-changelog, applies-to-tagging, page-opening-optimizer, frontmatter-description, docs-redirects, lens-chart-page, lens-chart-settings, content-type-checker, frontmatter-audit, skill-review, docs-check-style

---

Eval results

docs-syntax-help

Changes only affect the Substitutions section (new operators added). None of the 4 evals cover substitution operators — they test directive nesting, tab-set syncing, and callout syntax.

Eval	Result	Regressions
1 — Nested code block in note in tab	PASS	None
2 — Synced tabs with :group: / :sync:	PASS	None
3 — Callout markers in YAML code block	PASS	None
4 — Validate correctly-formed tab-set	PASS	None

docs-validate-code-samples

Changes only affect the G-2 ES|QL command allowlist. None of the 6 evals exercise ES|QL command recognition — they cover JSON validation (Check E), subs attributes (Check B), and API lookup (Check F).

Eval	Result	Regressions
1 — JSON error flagging (console block)	PASS	None
2 — Callout markers stripped before JSON parse	PASS	None
3 — subs=true missing / unnecessary	PASS	None
4 — Painless triple-quoted strings	PASS	None
5 — Clean file, no issues	PASS	None
6 — _reindex API validation via MCP	PASS	None

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• elastic.github.io

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "elastic.github.io"

See Network Configuration for more information.

Generated by Weekly Skill Freshness Check · sonnet46 6.7M · ◷

[github-actions]

Protected files were modified in this pull request and require manual scrutiny before merge.

Please verify that each protected-file change is intentional, policy-compliant, and safe:

• Protected files: .claude-plugin/plugin.json