GitHub - sabir-gbs/the-polyglot-protocol: A senior-engineer protocol for polyglot code generation, architecture, testing, security, performance, and agent validation. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
sabir-gbs
the-polyglot-protocol
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>6 Commits<br>6 Commits
adapters
adapters
docs
docs
scripts
scripts
.gitignore
.gitignore
AGENTS.md
AGENTS.md
SKILL.md
SKILL.md
contributing.md
contributing.md
license.md
license.md
readme.md
readme.md
security.md
security.md
View all files
Repository files navigation
The Polyglot Protocol
A senior-engineer protocol for polyglot code generation, architecture, testing,<br>security, performance, and agent validation.
This project packages a portable skill for Codex, Claude Code, OpenCode, and<br>other skill-capable coding agents. It helps agents make disciplined coding<br>decisions across languages without inventing APIs, skipping repository<br>discovery, overengineering, or ignoring validation.
What It Includes
SKILL.md: skill entrypoint
docs/languages/: individualized guidance for 22 languages
docs/languages//readme.md: human-readable quality,<br>completeness, and accuracy decisions for each language
docs/language-guidelines.md: language selection and default-script policy
docs/workflow/dev-workflow.md: planning, audit, validation, and N/A rules
scripts/validate-workspace.py: full local validation
adapters/: lightweight guidance and human-readable README files for Codex,<br>Claude Code, and OpenCode
Quick Start
Use the skill folder directly from an agent that supports local skill folders,<br>or copy the relevant adapter into the target agent's expected guidance location.
One-Line Install
Codex:
git clone https://github.com/sabir-gbs/the-polyglot-protocol.git /tmp/the-polyglot-protocol && python /tmp/the-polyglot-protocol/scripts/install-skill.py --agent codex --force
Claude Code:
git clone https://github.com/sabir-gbs/the-polyglot-protocol.git /tmp/the-polyglot-protocol && python /tmp/the-polyglot-protocol/scripts/install-skill.py --agent claude-code --force
OpenCode:
git clone https://github.com/sabir-gbs/the-polyglot-protocol.git /tmp/the-polyglot-protocol && python /tmp/the-polyglot-protocol/scripts/install-skill.py --agent opencode --force
Custom location:
git clone https://github.com/sabir-gbs/the-polyglot-protocol.git /tmp/the-polyglot-protocol && python /tmp/the-polyglot-protocol/scripts/install-skill.py --target ~/path/to/skills/the-polyglot-protocol --force
Validate the project:
python scripts/validate-workspace.py
Expected result:
language guidance validation: PASS<br>language files: 22<br>language readmes: 22<br>operational files: 11<br>score: 100/100<br>workspace validation: PASS
Language Coverage
Bash, C, C#, C++, CSS, Dart, Go, HTML, Java, JavaScript, Kotlin, Lua, PHP,<br>Python, R, Ruby, Rust, Shopify Liquid, SQL, Swift, TypeScript, and Zig.
Core Principles
Preserve existing repository conventions.
Default operational scripts to Python unless the project already has a better<br>native script runner.
Use platform-native languages for product surfaces.
Prefer the shortest reliable supported path.
Verify dependency, runtime, and API claims from local code or official docs.
Treat unsupported checks as explicit N/A items with evidence.
Human-Readable Decision Guides
Each language has a dedicated README folder, for example:
docs/languages/python/readme.md
docs/languages/typescript/readme.md
docs/languages/rust/readme.md
These README files summarize the decisions that control codegen quality,<br>completeness, and accuracy. The full enforceable rules remain in the matching<br>top-level language file such as docs/languages/python.md.
Each coding environment adapter also has a README:
adapters/codex/readme.md
adapters/claude-code/readme.md
adapters/opencode/readme.md
Project Status
Current validation score: 100/100.
See docs/languages/score-report.md for the score report...