{"id":51361559,"url":"https://github.com/nidhal-saadaoui/code-to-docs-skill","last_synced_at":"2026-07-02T23:06:56.288Z","repository":{"id":363151495,"uuid":"1262019904","full_name":"nidhal-saadaoui/code-to-docs-skill","owner":"nidhal-saadaoui","description":"A Claude Code skill that generates README, architecture docs, API reference, onboarding guides, deployment docs, and ADRs from an existing codebase.","archived":false,"fork":false,"pushed_at":"2026-06-07T16:30:18.000Z","size":1306,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-07T18:16:48.728Z","etag":null,"topics":["ai","claude","claude-code","developer-tools","documentation","skill"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nidhal-saadaoui.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-07T13:18:43.000Z","updated_at":"2026-06-07T16:31:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nidhal-saadaoui/code-to-docs-skill","commit_stats":null,"previous_names":["nidhal-saadaoui/code-to-docs-skill"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/nidhal-saadaoui/code-to-docs-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nidhal-saadaoui%2Fcode-to-docs-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nidhal-saadaoui%2Fcode-to-docs-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nidhal-saadaoui%2Fcode-to-docs-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nidhal-saadaoui%2Fcode-to-docs-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nidhal-saadaoui","download_url":"https://codeload.github.com/nidhal-saadaoui/code-to-docs-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nidhal-saadaoui%2Fcode-to-docs-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35065754,"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-07-02T02:00:06.368Z","response_time":173,"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","claude","claude-code","developer-tools","documentation","skill"],"created_at":"2026-07-02T23:06:55.521Z","updated_at":"2026-07-02T23:06:56.280Z","avatar_url":"https://github.com/nidhal-saadaoui.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# code-to-docs\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/code-to-docs.png\" alt=\"Code to Docs\" width=\"600\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/nidhal-saadaoui/code-to-docs-skill/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/nidhal-saadaoui/code-to-docs-skill?style=for-the-badge\u0026color=blue\" alt=\"GitHub Release\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/subcommands-7-orange?style=for-the-badge\" alt=\"7 Subcommands\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/stacks-10-green?style=for-the-badge\" alt=\"10 Stacks\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/nidhal-saadaoui/code-to-docs-skill?style=for-the-badge\" alt=\"License\"\u003e\n\u003c/p\u003e\n\nA Claude Code skill that generates and updates documentation from an existing codebase.\n\n## What it generates\n\n| Subcommand   | Output                        | Description                                           |\n|--------------|-------------------------------|-------------------------------------------------------|\n| `readme`     | `README.md`                   | Project overview, quick start, usage, config          |\n| `arch`       | `ARCHITECTURE.md`             | System design, component diagram, data flow           |\n| `api`        | `docs/api.md`                 | API reference from routes, functions, or schemas      |\n| `onboard`    | `ONBOARDING.md`               | Contributor setup, test commands, project layout      |\n| `deployment` | `DEPLOYMENT.md`               | Build, deploy, env vars, health check, rollback       |\n| `adr`        | `docs/adr/NNN-title.md`       | One Architecture Decision Record per major choice     |\n| `update`     | edits existing docs in place  | Incremental update scoped to the current feature branch |\n| `testing`    | `TESTING.md`                  | Test strategy, layers, mocking patterns, coverage, CI   |\n| `data`       | `docs/data.md`                | Data model, schema, lineage diagram, data quality       |\n| `glossary`   | `GLOSSARY.md`                 | Domain terms, state machines, synonyms, business rules  |\n| `userguide`  | `docs/user-guide.md`          | Product guide written for end users or operators        |\n\n## Installation\n\n```bash\ngit clone https://github.com/nidhal-saadaoui/code-to-docs-skill.git ~/.claude/skills/code-to-docs\n```\n\nTo update to the latest version:\n\n```bash\ncd ~/.claude/skills/code-to-docs \u0026\u0026 git pull\n```\n\nThen invoke it in any project:\n\n```\n/code-to-docs readme\n/code-to-docs arch\n/code-to-docs api\n/code-to-docs onboard\n/code-to-docs deployment\n/code-to-docs adr\n/code-to-docs update\n```\n\n## Options\n\n**Custom output directory** — tell the skill where to write files:\n```\n/code-to-docs readme — put it in docs/\n```\n\n**GitHub Wiki format** — use `[[Page Name]]` links and flat filenames:\n```\n/code-to-docs arch — for our GitHub wiki\n```\n\n## How it works\n\n1. Detects the tech stack from manifest files (`package.json`, `go.mod`, `Cargo.toml`, `pom.xml`, etc.)\n2. Reads existing documentation before writing — extends rather than overwrites\n3. Uses inline docs (JSDoc, docstrings, Go doc comments) as authoritative source material\n4. Asks targeted clarifying questions when decisions can't be inferred from code (at most 3, or 5 for ADRs)\n5. For `update`: runs `git diff main...HEAD` to scope changes to the current feature branch only\n6. Writes output using Claude Code's built-in tools — no external dependencies\n\n## Structure\n\n```\ncode-to-docs/\n├── SKILL.md                   — workflow, subcommands, stack detection\n├── references/\n│   ├── readme-guide.md        — README rules per project type (library vs app vs CLI)\n│   ├── architecture-guide.md  — component patterns and Mermaid diagram rules\n│   ├── api-guide.md           — REST, GraphQL, and library API doc formats\n│   ├── onboarding-guide.md    — contributor setup and test workflow guide\n│   ├── deployment-guide.md    — deployment model detection and operator docs\n│   ├── adr-guide.md           — ADR format, decision detection, and rationale handling\n│   ├── update-guide.md        — git-diff-scoped incremental update workflow\n│   ├── testing-guide.md       — test strategy, layers, mocking patterns, coverage, CI\n│   ├── data-guide.md          — data model, dbt lineage, schema, and data quality docs\n│   ├── glossary-guide.md      — domain terms, state machines, synonyms, business rules\n│   └── userguide-guide.md     — user-facing product guide for end users or operators\n└── evals/\n    └── evals.json             — 17 test cases covering all subcommands and output options\n```\n\n## Example output\n\nThe [`preview/`](preview/) directory contains a complete set of docs generated for a fictional project — showing exactly what each subcommand produces:\n\n- [README.md](preview/README.md)\n- [ARCHITECTURE.md](preview/ARCHITECTURE.md) — with Mermaid component diagram\n- [docs/api.md](preview/docs/api.md) — endpoint reference with request/response examples\n- [ONBOARDING.md](preview/ONBOARDING.md) — setup, test commands, writing a test\n- [docs/adr/](preview/docs/adr/) — three Architecture Decision Records\n\n## Requirements\n\nClaude Code with access to `Bash`, `Read`, `Write`, and `Edit` tools. No other dependencies.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnidhal-saadaoui%2Fcode-to-docs-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnidhal-saadaoui%2Fcode-to-docs-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnidhal-saadaoui%2Fcode-to-docs-skill/lists"}