{"id":50939178,"url":"https://github.com/sardorazimov/codex-skills","last_synced_at":"2026-06-17T12:02:25.978Z","repository":{"id":354060877,"uuid":"1221908051","full_name":"sardorazimov/codex-skills","owner":"sardorazimov","description":"Codex Skills","archived":false,"fork":false,"pushed_at":"2026-04-26T23:16:10.000Z","size":60,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-27T01:16:05.117Z","etag":null,"topics":["ai-tools","codex-skill","developer-tools","miransas","python","rust","sdk"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sardorazimov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.MD","dco":null,"cla":null}},"created_at":"2026-04-26T20:41:45.000Z","updated_at":"2026-04-26T23:17:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sardorazimov/codex-skills","commit_stats":null,"previous_names":["sardorazimov/codex-skills"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/sardorazimov/codex-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sardorazimov%2Fcodex-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sardorazimov%2Fcodex-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sardorazimov%2Fcodex-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sardorazimov%2Fcodex-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sardorazimov","download_url":"https://codeload.github.com/sardorazimov/codex-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sardorazimov%2Fcodex-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34447266,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","codex-skill","developer-tools","miransas","python","rust","sdk"],"created_at":"2026-06-17T12:02:22.483Z","updated_at":"2026-06-17T12:02:25.959Z","avatar_url":"https://github.com/sardorazimov.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# codex-skils\n\nStructured AI/Codex engineering rules for serious developer repositories.\n\ncodex-skils is a Rust + Python CLI tool for managing project-level engineering\ninstructions through reusable skill files. It helps teams keep `AGENTS.md`,\nrepository rules, and AI-assisted development guidance consistent without\ncopying large blocks of text by hand.\n\nThe tool exists because AI/Codex workflows work best when repository rules are\nexplicit, versioned, reviewable, and easy to regenerate.\n\n## Features\n\n- Bootstrap project rule files with `init`.\n- Generate production-oriented skill templates with `skill`.\n- Merge local skills into `AGENTS.md` with an idempotent `apply` command.\n- List available built-in skills with descriptions.\n- Export skills as Markdown, JSON, or YAML.\n- Validate required project structure with `check`.\n- Generate files safely: existing files are not overwritten unless `--force` is used.\n- Preserve user-written content outside managed sections.\n\n## Quick Start\n\nFrom this repository:\n\n```bash\ncargo run -p codex-sk-cli --bin codex-skils -- init\ncargo run -p codex-sk-cli --bin codex-skils -- skill rust --write\ncargo run -p codex-sk-cli --bin codex-skils -- apply --dry-run\ncargo run -p codex-sk-cli --bin codex-skils -- apply\ncargo run -p codex-sk-cli --bin codex-skils -- codex --output prompt.txt\ncargo run -p codex-sk-cli --bin codex-skils -- check\n```\n\nExample output:\n\n```text\napply complete\nfound 1 skill(s)\nupdated AGENTS.md (managed section added)\n```\n\n## Example Workflow\n\nStart with an existing repository that has a `README.md` but no Codex rule\nsystem.\n\n1. Initialize codex-skils:\n\n   ```bash\n   codex-skils init\n   ```\n\n   This creates:\n\n   ```text\n   AGENTS.md\n   .codex-skils/\n   .codex-skils/config.toml\n   .codex-skils/skills/\n   ```\n\n2. Add skills:\n\n   ```bash\n   codex-skils skill rust --write\n   codex-skils skill security --write\n   codex-skils skill testing --write\n   ```\n\n3. Preview the merge:\n\n   ```bash\n   codex-skils apply --dry-run --readme\n   ```\n\n   Example output:\n\n   ```text\n   apply complete\n   found 3 skill(s)\n   would update AGENTS.md (managed section added)\n   would update README.md (managed section added)\n   dry run: no files changed\n   ```\n\n4. Apply the rules:\n\n   ```bash\n   codex-skils apply --readme\n   ```\n\n5. Validate the project:\n\n   ```bash\n   codex-skils check\n   ```\n\n## CLI Usage\n\n### `init`\n\nBootstrap codex-skils files.\n\n```bash\ncodex-skils init\ncodex-skils init --force\n```\n\n`init` creates `AGENTS.md`, `.codex-skils/`, `.codex-skils/skills/`, and\n`.codex-skils/config.toml`. Existing files are skipped unless `--force` is\nprovided.\n\n### `skill`\n\nPrint or write a built-in skill template.\n\n```bash\ncodex-skils skill rust\ncodex-skils skill python --format json\ncodex-skils skill security --format yaml\ncodex-skils skill testing --write\ncodex-skils skill testing --write --force\n```\n\nBy default, skills are printed as Markdown. `--write` saves the skill to\n`.codex-skils/skills/\u003cname\u003e.md`.\n\n### `apply`\n\nMerge local skill files into project documentation.\n\n```bash\ncodex-skils apply\ncodex-skils apply --dry-run\ncodex-skils apply --force\ncodex-skils apply --readme\ncodex-skils apply --readme --force\n```\n\n`apply` is idempotent. Re-running it does not duplicate skill content.\n\n### `codex`\n\nGenerate a Codex-ready system prompt from `AGENTS.md` and local skills.\n\n```bash\ncodex-skils codex\ncodex-skils codex --print\ncodex-skils codex --compact\ncodex-skils codex --explain\ncodex-skils codex --output prompt.txt\n```\n\nThe prompt includes a senior engineer role, repository context, active skill\nsummary, merged skill content, execution rules, validation rules, and concise\noutput guidance. Use `--compact` for a shorter rules-only prompt and `--explain`\nto include how the prompt was assembled.\n\n### `list`\n\nShow all built-in skills and short descriptions.\n\n```bash\ncodex-skils list\n```\n\nExample output:\n\n```text\navailable skills\nrust - Rust crate, CLI, runtime, and protocol engineering.\npython - Python SDK and developer-facing API work.\nopensource - Contributor workflow and maintainer documentation.\ndevops - CI, release checks, scripts, and automation.\nsecurity - Validation, secret handling, and security-sensitive changes.\ntesting - Test strategy, fixtures, and regression coverage.\n```\n\n### `export`\n\nExport built-in skills.\n\n```bash\ncodex-skils export --all\ncodex-skils export --all --format json\ncodex-skils export --all --format yaml\ncodex-skils export --all --output .codex-skils/export\ncodex-skils export --all --format json --output .codex-skils/export\n```\n\nMarkdown export writes one file per skill when `--output` is used. JSON and YAML\nexport write `skills.json` or `skills.yaml`.\n\n### `check`\n\nValidate the expected project structure.\n\n```bash\ncodex-skils check\n```\n\nExample output:\n\n```text\ncheck passed\nvalid README.md\nvalid AGENTS.md\nvalid CONTRIBUTING.md\nvalid SECURITY.md\nvalid .codex-skils/config.toml\nvalid .codex-skils/skills\n```\n\n## Available Skills\n\n- `rust`: Rust crate, CLI, runtime, and protocol engineering.\n- `python`: Python SDK and developer-facing API work.\n- `opensource`: contributor workflow and maintainer documentation.\n- `devops`: CI, release checks, scripts, and automation.\n- `security`: validation, secret handling, and security-sensitive changes.\n- `testing`: test strategy, fixtures, and regression coverage.\n\n## How Apply Works\n\n`codex-skils apply` reads Markdown files from `.codex-skils/skills/*.md`, sorts\nthem alphabetically, and merges them into `AGENTS.md` inside a managed section:\n\n```md\n\u003c!-- codex-skils:start --\u003e\n## Skills\n\n... generated content ...\n\n\u003c!-- codex-skils:end --\u003e\n```\n\nOnly the managed section is replaced. Content outside the markers is preserved.\nIf `AGENTS.md` does not exist, it is created. If managed markers are malformed,\nthe command fails with a clear error unless `--force` is used.\n\nWith `--readme`, codex-skils also manages a `README.md` section:\n\n```md\n\u003c!-- codex-skils:readme:start --\u003e\n## Development Rules\n\nThis project uses codex-skils to manage AI/Codex engineering rules.\n\nActive skills:\n\n- README\n- rust\n\n\u003c!-- codex-skils:readme:end --\u003e\n```\n\nUse `--dry-run` before applying changes in a repository with existing rules.\n\n## Project Structure\n\n```text\n.\n├── AGENTS.md\n├── README.md\n└── .codex-skils/\n    ├── config.toml\n    └── skills/\n        ├── rust.md\n        ├── security.md\n        └── testing.md\n```\n\nConfiguration is intentionally small:\n\n```toml\nschema_version = 1\nproject_name = \"codex-skils\"\ndefault_skills = [\"rust\", \"python\", \"opensource\"]\n```\n\n## Development\n\nRust checks:\n\n```bash\ncargo fmt --all --check\ncargo check --workspace\ncargo clippy --workspace --all-targets --all-features -- -D warnings\ncargo test --workspace\n```\n\nPython checks:\n\n```bash\npython -m pip install -e bindings/python\npython -m pytest bindings/python/tests\n```\n\n## Contributing\n\nContributions should be small, reviewed, and tested. Before opening a pull\nrequest, run the relevant checks and include the commands in the PR description.\nSee `CONTRIBUTING.md` for project guidelines.\n\n## License\n\nLicensed under the Apache License, Version 2.0. See `LICENSE` for details.\nSee the architecture overview: [docs/architecture/overview.md](docs/architecture/overview.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsardorazimov%2Fcodex-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsardorazimov%2Fcodex-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsardorazimov%2Fcodex-skills/lists"}