Fähigkeiten technical-clarity
🔍

technical-clarity

Sicher 🌐 Netzwerkzugriff📁 Dateisystemzugriff⚙️ Externe Befehle

Revisar conteúdo técnico para clareza

O conteúdo técnico frequentemente contém barreiras ocultas como linguagem de gatekeeping, jargão indefinido e níveis de leitura incompatíveis. Esta habilidade analisa sistematicamente o conteúdo através de uma lente de raciocínio, identificando problemas de acessibilidade antes que os aprendizes os encontrem.

Unterstützt: Claude Codex Code(CC)
🥉 72 Bronze
1

Die Skill-ZIP herunterladen

2

In Claude hochladen

Gehe zu Einstellungen → Fähigkeiten → Skills → Skill hochladen

3

Einschalten und loslegen

Teste es

Verwendung von "technical-clarity". Review this decorator explanation for B1 (intermediate) learners: 'Obviously, decorators are simple. Just wrap your function and you are done.'

Erwartetes Ergebnis:

  • Clarity Score: 1.5/5 (Needs Significant Improvement)
  • CRITICAL: Gatekeeping language detected (3 violations: 'Obviously,' 'simple,' 'Just')
  • CRITICAL: Core terms undefined ('decorator' and 'wrap' never defined)
  • IMPORTANT: Missing context - prerequisites not stated, no motivation given
  • Enhancement: Add concrete usage example before abstract explanation

Verwendung von "technical-clarity". Audit this documentation section for A2 (beginner) learners. Check for accessibility, reading level, and jargon.

Erwartetes Ergebnis:

  • Accessibility Score: 3/5 (Partially Accessible)
  • Flesch-Kincaid Grade Level: 10 (target: 6-8 for A2)
  • Issues: 5 undefined terms per paragraph (limit: 2-3)
  • Recommendations: Break sentences over 25 words, replace complex terms, add visual descriptions for screen readers

Qualitätsbewertung

38
Architektur
100
Wartbarkeit
87
Inhalt
31
Community
100
Sicherheit
100
Spezifikationskonformität

Was du bauen kannst

Revisão de documentação

Revisar docs de API, tutoriais e material de referência para acessibilidade do aprendiz antes da publicação

Auditoria de conteúdo educacional

Validar se o conteúdo instrucional corresponde à camada de dificuldade e nível de leitura pretendidos

Avaliação de clareza

Identificar e sinalizar passagens obscuras, definições ausentes e barreiras de compreensão

Probiere diese Prompts

Verificação rápida de clareza
Revise este [parágrafo/seção] para clareza técnica. Público-alvo: aprendizes [A2/B1/B2+]. Sinalize qualquer linguagem de gatekeeping, jargão indefinido ou problemas de acessibilidade.
Auditoria detalhada
Execute uma auditoria completa de clareza técnica neste [documento/capítulo]. Siga a estrutura de 5 perguntas: Contexto do Público, Lacuna de Legibilidade, Necessidade de Jargão, Completude, Acessibilidade. Forneça uma pontuação e sugestões de revisão específicas.
Análise de jargão
Analise este conteúdo quanto a termos técnicos indefinidos. Liste cada termo indefinido, onde aparece e uma definição sugerida apropriada para aprendizes [A2/B1/B2+].
Varredura de gatekeeping
Varra este conteúdo para linguagem de gatekeeping (obviamente, simplesmente, é claro, meramente, trivialmente, todos sabem). Liste cada ocorrência com sugestões de substituição que explicam ao invés de minimizar.

Bewährte Verfahren

  • Sempre especifique o nível de proficiência alvo (A2/B1/B2+) antes de revisar
  • Aplique todos os 5 conjuntos de perguntas sistematicamente para análise completa
  • Distinga entre jargão necessário (específico do domínio) e jargão desnecessário

Vermeiden

  • Aceitar 'obviamente' ou 'simplesmente' como linguagem de esclarecimento aceitável
  • Pular verificação de acessibilidade para exemplos de código e formatação
  • Assumir que aprendizes B2+ não precisam de andaimes ou definições

Häufig gestellte Fragen

Que níveis de proficiência esta habilidade suporta?
A1 (iniciante), A2 (elementar), B1 (intermediário), B2 (intermediário superior) e C1 (avançado). Especifique o nível alvo nos prompts.
Esta habilidade edita meu conteúdo automaticamente?
Não. A habilidade identifica problemas e fornece sugestões de revisão. Você aplica as mudanças.
Posso usar isso com outras habilidades em um fluxo de trabalho?
Sim. Funciona bem com learning-objectives, code-example-generator e book-scaffolding para qualidade abrangente do conteúdo.
Esta habilidade acessa meus arquivos ou envia dados externamente?
Não. Esta é uma habilidade baseada puramente em prompts sem recursos de rede, sistema de arquivos ou execução de código.
Que alvos de nível de leitura devo usar?
A2: Série 6-8, B1: Série 9-12, B2+: Série 13+. Combine com o背景 do seu aprendiz.
Como isso é diferente de verificadores de gramática?
Verificadores de gramática corrigem estrutura de frases. Esta habilidade identifica barreiras de compreensão, linguagem de gatekeeping e problemas de acessibilidade que ferramentas de gramática não detectam.

Entwicklerdetails

Dateistruktur

📄 SKILL.md