{"id":50327385,"url":"https://github.com/tovrleaf/openkata","last_synced_at":"2026-05-29T07:31:54.613Z","repository":{"id":355708923,"uuid":"1200765708","full_name":"tovrleaf/openkata","owner":"tovrleaf","description":"Codified practices for AI agents — teach your agents the way.","archived":false,"fork":false,"pushed_at":"2026-05-25T21:21:03.000Z","size":581,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-25T22:25:11.387Z","etag":null,"topics":["agent-skills","ai-coding","developer-tools","golang","mcp","specification-driven-development"],"latest_commit_sha":null,"homepage":"","language":"Go","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/tovrleaf.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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-04-03T19:57:52.000Z","updated_at":"2026-05-25T21:21:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tovrleaf/openkata","commit_stats":null,"previous_names":["tovrleaf/openkata"],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/tovrleaf/openkata","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tovrleaf%2Fopenkata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tovrleaf%2Fopenkata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tovrleaf%2Fopenkata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tovrleaf%2Fopenkata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tovrleaf","download_url":"https://codeload.github.com/tovrleaf/openkata/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tovrleaf%2Fopenkata/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33642274,"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-05-29T02:00:06.066Z","response_time":107,"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","ai-coding","developer-tools","golang","mcp","specification-driven-development"],"created_at":"2026-05-29T07:31:52.060Z","updated_at":"2026-05-29T07:31:54.607Z","avatar_url":"https://github.com/tovrleaf.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Open Kata\n\nCodified practices for AI agents — teach your agents the way.\n\nSee the [Manifesto](MANIFESTO.md) for why this exists.\n\n## Vocabulary\n\n| Concept | Kata term | Description |\n|---------|-----------|-------------|\n| Skills | **kata** | Codified practices agents follow |\n| Rules | **dojo kun** | Always-on constraints applied to every session |\n| Roles | **sensei profiles** | Agent role definitions with scoped permissions |\n| Prompts | **kata forms** | Standardized templates for commits, PRs, reviews |\n| ADRs | **dojo records** | Architecture decisions preserved for the school |\n| MCP server | **the dojo** | Where kata are served and practiced |\n| Framework | **the ryu** (school) | The complete system of practices |\n\n## Design philosophy\n\nKata in this repo are **platform-agnostic**. They follow the\n[Agent Skills specification](https://github.com/anthropics/agent-skills-spec)\nand work with any agent that supports it — Kiro, Claude Code,\nOpenCode, or others. Skills avoid coupling to specific tooling,\nMCP servers, or platform-specific features so they remain\nportable across environments.\n\n## Using kata from this repository\n\nEach kata lives in its own folder under `skills/`. To use a kata:\n\n1. **Copy the skill folder** into your project's `.agents/skills/` directory\n2. Your agent will discover it automatically on the next session\n\n```bash\ncp -r skills/create-adr /path/to/your-project/.agents/skills/\n```\n\nOr use the dojo (MCP server) to install kata into your project — see\n[cmd/openkata-mcp/README.md](cmd/openkata-mcp/README.md) for setup.\n\n## Available kata\n\n| Kata | Description |\n|------|-------------|\n| [create-adr](skills/create-adr/) | Detects architectural decisions in conversation and guides creation of Architecture Decision Records |\n| [commit-conventions](skills/commit-conventions/) | Enforces Conventional Commits format and branch naming conventions |\n| [create-skill](skills/create-skill/) | Creates agent skills by investigating repo conventions, designing workflows, and writing SKILL.md files |\n| [create-rule](skills/create-rule/) | Creates always-on agent rules by investigating repo conventions and writing RULE.md files |\n| [create-profile](skills/create-profile/) | Creates sensei profiles that define agent roles with scoped permissions and constraints |\n| [grill-me](skills/grill-me/) | Challenges a plan, spec, or ADR by interviewing the user until all corners are covered |\n| [makefile-conventions](skills/makefile-conventions/) | Structures Makefiles as a universal command interface using modular includes and self-documenting help |\n| [spec-workflow](skills/spec-workflow/) | Drives feature development through a phased workflow: specify, design, tasks, implement, and validate |\n\n## Available dojo kun\n\n| Rule | Description |\n|------|-------------|\n| [markdown-style](rules/markdown-style/) | Consistent markdown formatting conventions applied to all generated files |\n| [bash-style](rules/bash-style/) | Bash scripting conventions based on the Google Shell Style Guide |\n| [design-system](rules/design-system/) | Token-based CSS design system conventions |\n| [git-naming](rules/git-naming/) | Branch naming, commit message format, and trailer conventions |\n\n## Available sensei profiles\n\n| Profile | Description |\n|---------|-------------|\n| [frontend-developer](profiles/frontend-developer.md) | Frontend developer scoped to web UI — templates, styles, and handlers only |\n| [spec-planner](profiles/spec-planner.md) | Plans features through specs, designs, and task breakdowns |\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for how to add skills\nand rules. See [AGENTS.md](AGENTS.md) for build commands, code\nstyle, and commit conventions. See [RELEASING.md](RELEASING.md)\nfor how to publish skills and deploy.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftovrleaf%2Fopenkata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftovrleaf%2Fopenkata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftovrleaf%2Fopenkata/lists"}