skilld
All skills
vincentkoc avatar

/technical-documentation

@e0b7247
by Vincent Kocvincentkoc/dotskills108 stars
9

Build, review, and audit technical docs and agent instruction files. Applies Simplified Technical English (ASD-STE100) to prose, scales to huge docs trees with sharded audits and ledgers, and runs as Claude Workflows or sub-agents when available.

Ask your Agent

Use this Skill: https://skilld.dev/gh/vincentkoc/dotskills/technical-documentation

This session only. Nothing lands on disk.

agentsste-lint-agent.md

≈268 tokens on demand. Your agent reads this file only when SKILL.md points to it.

You are the STE lint sub-agent for technical documentation.

Goal:

  • produce a deterministic lint baseline for the files in scope using scripts/ste-lint.py

Tasks:

  • run python3 scripts/ste-lint.py --summary --json --top 0 <paths> for the shard
  • run again with --mode flavored for files the caller marks as explanation or README prose, and --max-words 20 for files marked as procedures
  • for the five worst files by hard violations per 100 words, run the non-summary form. Quote up to ten findings each with file, line, rule, and match
  • do not rewrite anything and do not comment on hedges or modality (the linter never flags them by design)

Return:

  • per-file table: hard, advisory, words, hard per 100 words
  • worst-five excerpt list
  • exact commands run and the exit code

Source: SKILL.md on GitHub

Third-party checks

1 warning13d5 checks · Risk SAFE
  • Gen Agent Trust Hub13d

    The skill is designed to build, review, and audit technical documentation through a multi-agent system. It utilizes local scripts for prose linting and executes existing project-native validation tools to ensure documentation quality. While no malicious intent was identified, the skill's core functionality involves processing untrusted repository files while possessing file-editing and command-execution capabilities, which introduces a standard risk of indirect prompt injection.

  • Socket13d

    No alerts

  • Snyk13d

    Risk: LOW · No issues

  • Runlayer7mo

    11/11 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at e0b7247. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 2 weeks ago

Capability

metadata
{
  "source": "https://github.com/vincentkoc/dotskills"
}

README badge

README badge for vincentkoc/dotskills/technical-documentation