low-level-dev-skills: Instructions file for Codex

AGENTS.md

Guidelines for AI agents working in this repository.

Project Overview

A curated suite of AI agent skills for systems and low-level C/C++ development toolchains. Each skill is a markdown file following the SKILL.md format. Skills are organized by category and cross-reference each other.

Repository Structure

skills/
├── compilers/        # gcc, clang, llvm, msvc-cl, cross-gcc
├── debuggers/        # gdb, lldb, core-dumps
├── profilers/        # linux-perf, valgrind, flamegraphs
├── build-systems/    # cmake, make, ninja
├── binaries/         # elf-inspection, linkers-lto, binutils
├── runtimes/         # sanitizers, fuzzing
└── low-level-programming/  # assembly-x86, assembly-arm, interpreters

Each skill has a SKILL.md file and optional references/ for detailed content.

Validation Commands

# Validate markdown formatting (requires markdownlint-cli)
markdownlint skills/**/*.md

# Check skill frontmatter is valid YAML
head -5 skills/compilers/gcc/SKILL.md

# Verify all skills have required sections
grep -l "## Purpose" skills/**/SKILL.md | wc -l
grep -l "## Triggers" skills/**/SKILL.md | wc -l
grep -l "## Workflow" skills/**/SKILL.md | wc -l
grep -l "## Related" skills/**/SKILL.md | wc -l

# Check cross-reference format (should use backticks, not links)
grep -r "skills/[a-z]" skills/ --include="*.md" | grep -v "`skills/"

SKILL.md Format

YAML Frontmatter

---
name: skill-name
description: <skill-name> skill for <domain>. Use when <scenarios>. Activates on <triggers>.
---

• name: Lowercase, hyphen-separated, matches directory name
• description: Must include "Use when" and "Activates on" clauses

Required Sections

Every SKILL.md must have:

1. Purpose (1-2 sentences): What the skill does
2. Triggers (4-6 items): User query patterns that activate this skill
3. Workflow (numbered subsections): Step-by-step guidance with:
   • Decision trees (ASCII in code blocks)
   • Command tables
   • Code examples with language tags
   • Error/symptom tables
4. Related skills (2+ references): Cross-references using backtick format