Skip to content

fix: move top-level version into metadata for Codex skill validation #806

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
huangzigen666 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

fix: move top-level version into metadata for Codex skill validation #806

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion codex/skills/conventions-antigravity/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: conventions-antigravity
description: Use when scoring or writing Antigravity (or legacy Gemini CLI) artifacts — covers .gemini/ paths, .agent/ workspace skills, gemini-extension.json, GEMINI.md, TOML slash commands, Gemini-lineage hook events. Spec is unsettled (Antigravity 2.0 launched 2026-05-19); many checks are advisory until PR-B verification.
version: 0.1.0
metadata:
version: 0.1.0
---

# Antigravity Conventions (with Gemini CLI legacy)
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/conventions-claude/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: conventions-claude
description: Use when scoring or writing Claude Code artifacts — covers .claude/ paths, plugin.json schema, command + agent + skill frontmatter, CLAUDE.md, hook events, hooks.json format, settings.json, LSP, monitors, memory file conventions, and the Claude Code built-in tool catalog. Refreshed 2026-08-02 against current docs (Claude Code ≥ v2.1.218).
version: 0.3.0
metadata:
version: 0.3.0
---

# Claude Code Conventions
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/conventions-codex/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: conventions-codex
description: Use when scoring or writing Codex CLI artifacts — covers .codex/config.toml schema, .codex-plugin/plugin.json, .agents/skills/ layout, Codex hook events, AGENTS.md hierarchy, marketplace.json, and the agents/openai.yaml sidecar. Refreshed 2026-08-02 against Codex 0.146.0 (2026-07-29).
version: 0.3.1
metadata:
version: 0.3.1
---

# Codex CLI Conventions
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/conventions/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: conventions
description: "Universal NL programming conventions — SKILL.md open spec (agentskills.io), AGENTS.md as canonical universal memory file, vague-quantifier list, prompt engineering layers, naming conventions, the override system. Tool-specific schemas live in nlpm:conventions-claude / nlpm:conventions-codex / nlpm:conventions-antigravity."
version: 0.2.1
metadata:
version: 0.2.1
Comment on lines +4 to +5

@chatgpt-codex-connector chatgpt-codex-connector Bot Aug 8, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Bump the release version for the shipped skill changes

When this fix is published, all plugin and marketplace manifests still advertise version 1.2.4, so consumers or registries that treat a published version as immutable can retain the invalid pre-fix skill files instead of receiving these corrected copies. Update the relevant plugin.json and marketplace.json versions with this change.

AGENTS.md reference: AGENTS.md:L110-L115

Useful? React with 👍 / 👎.

---

# Universal NL Programming Conventions
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/orchestration/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: orchestration
description: Multi-agent workflow patterns for Claude Code -- parallel dispatch, sequential pipelines, QC gates, retry loops, shared partials. Use when designing systems with multiple agents, commands, or processing stages.
version: 0.1.0
metadata:
version: 0.1.0
---

# Orchestration
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/patterns/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: patterns
description: Use when writing or reviewing NL artifacts and need to check for anti-patterns — vague quantifiers, prohibitions without alternatives, oversized skills, write-on-read-only agents, monolithic prompts, or linter-duplicating rules.
version: 0.1.0
metadata:
version: 0.1.0
---

# NL Programming Patterns
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/rules/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: rules
description: The 50 rules of natural language programming. Loaded when writing, reviewing, or improving any NL artifact — skills, agents, commands, rules, hooks, prompts, plugins, and the project memory file (CLAUDE.md / AGENTS.md / GEMINI.md). The definitive style guide for NL code quality.
version: 0.2.0
metadata:
version: 0.2.0
---

# The Rules of Natural Language Programming
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/scoring/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: scoring
description: Use when scoring NL artifact quality, applying penalties, or calibrating lint judgment — contains the 100-point rubric with penalty tables per artifact type. Four worked calibration examples (Excellent Agent / Rewrite Agent / Excellent Rule / Weak Rule) live in `references/calibration-examples.md`, loaded on demand when anchoring borderline cases.
version: 0.3.1
metadata:
version: 0.3.1
---

# NLPM Quality Scoring Rubric
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/security/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: security
description: Detects execution surface risks, supply chain vulnerabilities, data exfiltration vectors, and prompt injection patterns in Claude Code plugins. Use when auditing plugins for security risks, reviewing MCP server configurations, scanning hooks and scripts for vulnerabilities, or checking extensions before installation.
version: 0.1.0
metadata:
version: 0.1.0
---

# Security Scan Patterns for Claude Code Plugins
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/testing/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: testing
description: "Use when writing test specs for NL artifacts, running /nlpm:test, or setting up TDD workflows for skills, agents, commands, rules, hooks, and prompts."
version: 0.1.0
metadata:
version: 0.1.0
---

## The NL-TDD Cycle
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/vocabulary/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: vocabulary
description: Use when writing, reviewing, or naming any NLPM artifact (command, agent, skill, rule, workflow) — pick the canonical noun or verb from this registry rather than coining a synonym. Loaded by the scorer and checker agents to detect vocabulary drift across artifacts.
version: 0.1.0
metadata:
version: 0.1.0
---

# NLPM Domain Vocabulary
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/writing-agents/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: writing-agents
description: How to write Claude Code agents that trigger reliably, use the right model, and produce consistent output. Use when creating, improving, or reviewing agent definitions.
version: 0.2.0
metadata:
version: 0.2.0
---

# Writing Agents
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/writing-hooks/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: writing-hooks
description: How to write Claude Code hooks -- event selection, hook types, matcher patterns, blocking vs advisory, portable paths. Use when creating hooks for quality gates, automation, or policy enforcement.
version: 0.2.0
metadata:
version: 0.2.0
---

# Writing Hooks
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/writing-plugins/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: writing-plugins
description: How to design and build plugins -- architecture decisions, artifact selection, file structure, manifest configuration, marketplace publishing. Primarily Claude Code (.claude-plugin/plugin.json); the same architecture maps to Codex CLI (.codex-plugin/plugin.json) and Antigravity extensions. Use when planning, creating, or reviewing a plugin.
version: 0.2.0
metadata:
version: 0.2.0
---

# Writing Plugins
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/writing-prompts/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: writing-prompts
description: How to write effective system prompts for any LLM. Universal prompt engineering -- role clarity, structured output, injection resistance, few-shot examples. Use when writing prompts, system instructions, or AI configuration.
version: 0.1.0
metadata:
version: 0.1.0
---

# Writing Prompts
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/writing-rules/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: writing-rules
description: How to write .claude/rules/ files that Claude actually follows. Use when creating, improving, or reviewing project rules.
version: 0.2.0
metadata:
version: 0.2.0
---

# Writing Rules
Expand Down
3 changes: 2 additions & 1 deletion codex/skills/writing-skills/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: writing-skills
description: How to write SKILL.md files that trigger reliably and teach effectively. Use when creating, improving, or reviewing skills for any tool — SKILL.md is the cross-tool open spec (agentskills.io), read identically by Claude Code, Codex CLI, and Antigravity.
version: 0.2.0
metadata:
version: 0.2.0
---

# Writing Skills
Expand Down