{"id":51581162,"url":"https://github.com/dd3ok/onboardkit","last_synced_at":"2026-07-11T06:30:58.218Z","repository":{"id":370697106,"uuid":"1293099094","full_name":"dd3ok/onboardkit","owner":"dd3ok","description":"A lightweight Agent Skill for initializing and maintaining AGENTS.md and repository docs.","archived":false,"fork":false,"pushed_at":"2026-07-10T09:37:02.000Z","size":123,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-10T11:08:25.919Z","etag":null,"topics":["agent-skills","agents-md","codex","developer-tools","documentation"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dd3ok.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-07-08T05:30:11.000Z","updated_at":"2026-07-10T06:49:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dd3ok/onboardkit","commit_stats":null,"previous_names":["dd3ok/onboardkit"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/dd3ok/onboardkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dd3ok%2Fonboardkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dd3ok%2Fonboardkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dd3ok%2Fonboardkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dd3ok%2Fonboardkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dd3ok","download_url":"https://codeload.github.com/dd3ok/onboardkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dd3ok%2Fonboardkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35353668,"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-11T02:00:05.354Z","response_time":104,"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":["agent-skills","agents-md","codex","developer-tools","documentation"],"created_at":"2026-07-11T06:30:57.212Z","updated_at":"2026-07-11T06:30:58.213Z","avatar_url":"https://github.com/dd3ok.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# onboardkit\n\nonboardkit is a lightweight Agent Skill designed primarily for Codex to maintain `AGENTS.md` and agent-facing repo docs. Other Agent Skills runtimes are format-compatibility targets, not verified support.\n\nIt helps an agent decide:\n\n- how to initialize a small `AGENTS.md`\n- how to respect active overrides, fallback instructions, and nested scopes\n- how to fill discovered facts while avoiding invented repo-specific guidance\n- when to ask the user or report Needs Input instead of guessing\n- what belongs in always-on `AGENTS.md`\n- when to create `docs/README.md` and deeper docs\n- what stale, duplicate, generated, or low-signal docs should be removed\n- how README and agent-facing docs should stay aligned\n\nThere is no helper command, npm package, scaffolder, runner, dashboard, or task ledger in this repository.\n\n## Install\n\nFor Codex, ask the built-in installer to copy only the canonical runtime directory:\n\n```text\nUse $skill-installer to install onboardkit from https://github.com/dd3ok/onboardkit/tree/main/skills/onboardkit\n```\n\nRestart Codex if the installed skill does not appear. This route excludes repository-only docs, CI, and eval fixtures from the installed skill.\n\nFor other runtimes, copy only `skills/onboardkit/` into that runtime's current official user-level skills directory. Those runtimes remain format-compatibility targets, not verified support.\n\nClaude Code can use the Agent Skills format but does not automatically discover `AGENTS.md`; target repositories need `CLAUDE.md` routing, such as `@AGENTS.md`, for those instructions to apply.\n\nTo update an installer-managed copy, remove its installed `onboardkit` directory and repeat the installer prompt.\n\nExisting full-repository installations remain compatible through the root `SKILL.md` entrypoint. Update those legacy checkouts with:\n\n```bash\ngit -C ~/.agents/skills/onboardkit pull --ff-only\n```\n\nDo not use a full-repository checkout for new installations. Clone normally outside a skills directory for source development or repository validation.\n\nThen ask your coding agent in a target repository:\n\n```text\nUse onboardkit to clean up this repo's AGENTS.md and docs.\n```\n\nImplicit invocation is enabled. Invoke `$onboardkit` explicitly for cleanup. Deletion is authorized only when the request says delete/remove and supplies each literal file path or a file-matching glob; the agent must not broaden it, and a directory path alone is insufficient.\n\nCommon prompts:\n\n```text\nUse $onboardkit to initialize lightweight AGENTS.md and docs routing for this repo.\nUse $onboardkit to refresh this existing AGENTS.md, preserving it and changing only what evidence or routing requires.\nUse $onboardkit to audit AGENTS.md and agent-facing docs for stale or duplicate guidance without deleting files.\nUse $onboardkit to do a monthly maintenance pass on agent-facing docs.\n```\n\n## Files\n\n```text\n.github/workflows/validate.yml  repository-only static validation\nskills/onboardkit/              canonical runtime skill\nSKILL.md                        legacy compatibility entrypoint\nagents/openai.yaml              legacy UI metadata\nevals/evals.json                behavior evaluation cases\nevals/eval_queries.json         trigger boundary cases\nevals/files/                    isolated behavior fixtures\nAGENTS.md                       maintenance guidance for this repo\nREADME.md                       user-facing summary\nLICENSE                         source license\n.gitignore                      local-file exclusions\n.gitattributes                  Git text normalization\n```\n\n## Maintenance\n\nKeep the skill instruction-only unless a future requirement clearly needs deterministic tooling.\n\nUse the [AGENTS.md](AGENTS.md) Definition of Done as the canonical maintainer checklist. Keep runtime instructions and metadata under `skills/onboardkit/`; root skill files exist only for legacy full-checkout compatibility. Eval JSON and fixtures remain declarative, not a model runner; fresh release validation copies fixtures into isolated workspaces and compares current with baseline.\n\n## References\n\n- [OpenAI Codex skills](https://learn.chatgpt.com/docs/build-skills)\n- [OpenAI AGENTS.md guidance](https://learn.chatgpt.com/docs/agent-configuration/agents-md)\n- [OpenAI Codex best practices](https://learn.chatgpt.com/guides/best-practices)\n- [Claude Code memory guidance](https://code.claude.com/docs/en/memory)\n- [Claude Code skills](https://code.claude.com/docs/en/skills)\n- [GitHub Copilot repository instructions](https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions)\n- [Agent Skills specification](https://agentskills.io/specification)\n- [Agent Skills evaluation guide](https://agentskills.io/skill-creation/evaluating-skills)\n- [AGENTS.md](https://agents.md/)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdd3ok%2Fonboardkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdd3ok%2Fonboardkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdd3ok%2Fonboardkit/lists"}