{"id":49239712,"url":"https://github.com/netresearch/german-technical-writing-skill","last_synced_at":"2026-04-24T19:01:15.293Z","repository":{"id":353615312,"uuid":"1220172183","full_name":"netresearch/german-technical-writing-skill","owner":"netresearch","description":"Natural German technical register for Jira, MR descriptions, commit messages, release notes, and team-facing artifacts. Catches literal English to German anglicisms and substitutes the canonical technical lexicon.","archived":false,"fork":false,"pushed_at":"2026-04-24T18:01:25.000Z","size":58,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T18:25:54.287Z","etag":null,"topics":["agent-skills","ai-agent","claude-code-skill","deutsch","german","localization","open-standard","skill","style-guide","technical-writing"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netresearch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-CC-BY-SA-4.0","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-24T16:10:31.000Z","updated_at":"2026-04-24T18:01:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/netresearch/german-technical-writing-skill","commit_stats":null,"previous_names":["netresearch/german-technical-writing-skill"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/netresearch/german-technical-writing-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fgerman-technical-writing-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fgerman-technical-writing-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fgerman-technical-writing-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fgerman-technical-writing-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netresearch","download_url":"https://codeload.github.com/netresearch/german-technical-writing-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fgerman-technical-writing-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32236744,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-agent","claude-code-skill","deutsch","german","localization","open-standard","skill","style-guide","technical-writing"],"created_at":"2026-04-24T19:01:14.450Z","updated_at":"2026-04-24T19:01:15.285Z","avatar_url":"https://github.com/netresearch.png","language":null,"readme":"# German Technical Writing Skill\n\nNatural German technical register for Jira comments and descriptions, internal German-language wiki/spec pages, and team-chat messages to German-speaking colleagues.\n\nCatches literal English→German anglicisms (`brechen`, `gefangen`, `returnen`, `triggern`, `failen`) and substitutes the canonical technical lexicon (`werfen`, `abfangen`, `zurückgeben`, `auslösen`, `fehlschlagen`) while accepting ecosystem-standard Denglisch loanwords (`der Commit`, `die Pipeline`, `die Exception`).\n\n## 🔌 Compatibility\n\nThis is an **Agent Skill** following the [open standard](https://agentskills.io) originally developed by Anthropic and released for cross-platform use.\n\n**Supported Platforms:**\n- ✅ Claude Code (Anthropic)\n- ✅ Cursor\n- ✅ GitHub Copilot\n- ✅ Other skills-compatible AI agents\n\n\u003e Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.\n\n## Features\n\n- **Anti-pattern detection**: ~60 false-friends catalogued — `brechen`, `gefangen`, `returnen`, `failen`, `triggern`, `hitten`, plus calqued idioms (*am Ende des Tages*, *Low-hanging Fruit*) and pseudo-anglicisms (`Handy`, `Beamer`)\n- **Technical lexicon**: preferred German forms with gender for Exceptions, Tests, Git, CI/CD, HTTP, Frontend, Data, and Architecture domains\n- **Register enforcement**: Präsens-Indikativ default, impersonal voice, no first-person in artifacts, sentence-length and compound-noun rules, ß/ä/ö/ü orthography\n- **Artifact-specific conventions**: Jira ticket descriptions, Jira comments, internal German wiki/spec pages\n- **Worked examples**: 6 paired bad-vs-good cases with annotations\n\n## Installation\n\n### Marketplace (Recommended)\n\nAdd the [Netresearch marketplace](https://github.com/netresearch/claude-code-marketplace) once, then browse and install skills:\n\n```bash\n# Claude Code\n/plugin marketplace add netresearch/claude-code-marketplace\n/plugin install german-technical-writing\n```\n\n### npx ([skills.sh](https://skills.sh))\n\nInstall with any [Agent Skills](https://agentskills.io)-compatible agent:\n\n```bash\nnpx skills add https://github.com/netresearch/german-technical-writing-skill --skill german-technical-writing\n```\n\n### Download Release\n\nDownload the [latest release](https://github.com/netresearch/german-technical-writing-skill/releases/latest) and extract to your agent's skills directory.\n\n### Git Clone\n\n```bash\ngit clone https://github.com/netresearch/german-technical-writing-skill.git\n```\n\n### Composer (PHP Projects)\n\n```bash\ncomposer require netresearch/german-technical-writing-skill\n```\n\nRequires [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin).\n\n## Usage\n\nThe skill triggers automatically when composing German prose longer than one sentence for a German-audience artifact — Jira tickets and comments, internal German wiki/spec pages, or team-chat messages to German-speaking colleagues.\n\nExample queries:\n\n- *\"schreib bitte einen Jira-Kommentar auf OROSPD-692: der cart-merge-on-login Test failt weil ...\"*\n- *\"HMKG-2202 ticket beschreibung muss neu geschrieben werden — problem/ziel format auf deutsch\"*\n- *\"kurze Slack-Ankündigung ans HMKG team auf deutsch: Pipeline CI-383 ist grün\"*\n- *\"drei-satz blurb auf deutsch fürs internal-wiki über das MeyerBaselineBundle\"*\n\nThe skill does **not** trigger for commit messages, MR/PR descriptions, release notes (all English at Netresearch and most agencies delivering customer projects), conversational chat replies, single-word acknowledgements, or English artifacts that happen to contain German identifiers.\n\n## Structure\n\n```\nskills/german-technical-writing/\n├── SKILL.md              # Trigger description, process, top-anti-pattern table\n├── references/\n│   ├── anti-patterns.md  # ~60 false-friends catalogue with explanations\n│   ├── lexicon.md        # Technical term lexicon with gender\n│   ├── register.md       # Tense/voice/person, artifact conventions\n│   └── examples.md       # 6 paired real-world cases with annotations\n└── evals/\n    └── evals.json        # 15 trigger-eval queries with assertions\n```\n\n## Contributing\n\nIssues and pull requests welcome at \u003chttps://github.com/netresearch/german-technical-writing-skill/issues\u003e.\n\nWhen proposing new anti-pattern entries or lexicon additions, please include:\n\n1. The English concept\n2. The literal-translation form to avoid\n3. The preferred technical German form\n4. A brief explanation of **why** the literal form reads as anglicism\n\nSee `skills/german-technical-writing/references/examples.md` for the style of explanation we expect.\n\n## License\n\n- **Code** (`composer.json`, `plugin.json`, configs): [MIT](LICENSE-MIT)\n- **Prose** (`SKILL.md`, references, README): [CC-BY-SA-4.0](LICENSE-CC-BY-SA-4.0)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fgerman-technical-writing-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetresearch%2Fgerman-technical-writing-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fgerman-technical-writing-skill/lists"}