技能 technical-clarity
📦

technical-clarity

内容修订 r1 安全

提升技术写作清晰度

技术内容对专家来说可能很清楚，但会让学习者感到困惑。此技能会从受众匹配度、术语、缺失上下文、可访问性以及实用修订步骤等方面审阅草稿。

支持: Claude Codex Code(CC)
🥉 78 青铜

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。

智能体请求
Review the Skillstore skill "technical-clarity" from https://skillstore.io/skills/92bilal26-technical-clarity.md and its manifest at https://skillstore.io/api/skills/92bilal26-technical-clarity/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

你的智能体仍应展示其计划，并按安全策略请求必要确认。

Agent 可读资源

当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。

Markdown 详情 GET /skills/92bilal26-technical-clarity.md 已签名 manifest GET /api/skills/92bilal26-technical-clarity/manifest 已签名 lockfile GET /api/skills/92bilal26-technical-clarity/lockfile

测试它

正在使用“technical-clarity”。 一段声称某个概念显而易见并使用多个未定义术语的段落。

预期结果:

  • 标记可能让学习者感到被排除在外的门槛式语言。
  • 列出未定义术语，并建议首次使用时给出定义。
  • 建议更清晰的开头，解释该概念为什么重要。

正在使用“technical-clarity”。 一个在展示示例之前先从抽象理论开始的教程章节。

预期结果:

  • 将先抽象后示例的结构识别为理解风险。
  • 建议先放置具体示例，再进行解释。
  • 为目标学习者添加前置条件和动机说明。

正在使用“technical-clarity”。 依赖颜色和截图来解释错误的文档。

预期结果:

  • 将仅依赖视觉传达标记为可访问性问题。
  • 建议添加文本标签、说明文字和替代文本。
  • 建议适用于屏幕阅读器用户的措辞。

安全审计

安全
v5 • 2026/7/20 打开版本化报告

All 39 static detections are false positives. The external-command detections match Markdown code fences and inline-code examples, while the reconnaissance detections match ordinary educational prose. No executable commands, data collection, network activity, prompt injection, or malicious intent was found in SKILL.md.

1
已扫描文件
497
分析行数
0
复核项
0
已忽略误报
最新一次完成的静态与语义审计未检测到已确认的安全发现。这并不能证明该 Skill 没有副作用。
审计者: claude 查看审计历史 →
分享与引用此报告

分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。

打开版本化报告
安全评估

复制报告链接

https://skillstore.io/skills/92bilal26-technical-clarity/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/92bilal26-technical-clarity/security.svg)](https://skillstore.io/skills/92bilal26-technical-clarity?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/92bilal26-technical-clarity?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/92bilal26-technical-clarity/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/92bilal26-technical-clarity.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
学术引用 (APA · BibTeX · CFF)

APA 引用

92Bilal26. (2026). technical-clarity security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/92bilal26-technical-clarity/audits/5

BibTeX 引用

@techreport{92bilal26-92bilal26-technical-clarity-2026, author = {92Bilal26}, title = {technical-clarity security audit report (audit version 5)}, institution = {Skillstore}, year = {2026}, number = {5}, url = {https://skillstore.io/skills/92bilal26-technical-clarity/audits/5}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "technical-clarity security audit report (audit version 5)" version: "unspecified" type: report authors: - name: "92Bilal26" date-released: "2026-07-20" url: "https://skillstore.io/skills/92bilal26-technical-clarity/audits/5" identifiers: - type: other value: "skillstore:92bilal26-technical-clarity:audit:5" description: "Skillstore immutable audit report identifier"

Skillstore 评分

评分依据 证据置信度: 高
55
架构
85
可维护性
87
内容
70
社区
83
规范符合性

你能构建什么

审阅入门教程

检查教程是否解释了前置条件、定义了术语，并避免专家式假设。

准备 API 文档

改进参考文本，使读者理解用途、约束、示例和错误情况。

审核课程材料

评估课程的阅读水平、术语密度、可访问性和学习者信心。

试试这些提示

快速清晰度检查 
Review this technical explanation for clarity. Identify confusing phrases, undefined terms, and missing context. Target audience: beginner. Draft: [paste text].
受众水平审阅 
Audit this content for a B1 intermediate learner. Check sentence length, jargon density, prerequisites, examples, and accessibility. Provide prioritized fixes. Content: [paste text].
教程修订计划 
Review this tutorial and create a revision plan. Focus on show-before-tell structure, definitions, motivation, error cases, and learner confidence. Tutorial: [paste text].
完整文档审核 
Perform a full technical clarity audit for this documentation. Include audience assumptions, readability risks, accessibility issues, issue severity, impact, and rewritten examples where useful. Documentation: [paste text].

最佳实践

  • 提供目标受众、学习场景和预期前置知识。
  • 要求给出问题严重程度、对学习者的影响以及具体改写建议。
  • 在应用重大清晰度改动后，再次审阅修订后的文本。

避免

  • 当你需要学习者理解分析时，不要只要求通用校对。
  • 不要省略目标熟练程度或预期读者背景。
  • 不要在未检查示例、上下文和可访问性的情况下接受可读性评分。

常见问题

此技能可以审阅哪些类型的内容？
它可以审阅技术文档、教程、课程课时、API 指南、示例和教育性解释。
它会改写文档吗？
它可以建议改写和更清晰的示例，但其主要用途是结构化清晰度审核。
它可以检查可访问性吗？
可以。它会检查仅依赖视觉的提示、缺失的替代文本、代码可读性和不清晰的结构。
它会验证代码正确性吗？
不能。它专注于理解和可访问性，而不是运行时行为或技术验证。
我的提示中应该包含什么？
请包含草稿、目标受众、熟练程度、内容类型以及任何已知前置条件。
Claude、Codex 和 Claude Code 可以使用它吗？
可以。报告列出了对 Claude、Codex 和 Claude Code 的支持。

开发者详情

作者

92Bilal26

许可证

MIT

Skillstore 修订

r1

版本提示

作者未声明版本。

仓库

https://github.com/92Bilal26/TaskPilotAI/tree/main/.claude/skills/technical-clarity

引用

820ccb93d2e2fe828678ed05433bafd1054e5000

维护新鲜度

2026/7/21

使用量

13 次下载 · 194 次浏览

文件结构

📄 SKILL.md

92Bilal26 的更多技能

查看全部

相关技能

查看全部