documentation-writing

Pass

Audited by Gen Agent Trust Hub on Nov 2, 2026

Risk Level: SAFECOMMAND_EXECUTIONEXTERNAL_DOWNLOADSINDIRECT_PROMPT_INJECTION
Full Analysis
  • [COMMAND_EXECUTION]: The skill uses the subprocess module to automate documentation workflows. github_pages/generator.py executes mkdocs build to generate static sites, and github_pages/deployer.py executes multiple git commands for deployment. To mitigate command injection risks, the skill implements specific validation functions like _validate_branch_name (which blocks dangerous characters such as semicolons and pipes) and _validate_github_url (which ensures operations are restricted to GitHub repositories).
  • [EXTERNAL_DOWNLOADS]: The github_pages/README.md file recommends the installation of mkdocs, mkdocs-material, and pyyaml. These are well-known and trusted packages within the Python ecosystem for documentation purposes and are categorized as safe dependencies.
  • [INDIRECT_PROMPT_INJECTION]: The skill has a defined attack surface for indirect prompt injection as it ingests content from project files and user instructions to generate documentation.
  • Ingestion points: Content is read from the docs/ directory and project README.md files during the generation and validation phases.
  • Boundary markers: The skill does not explicitly use security delimiters for user-provided text, but it enforces a strict structural framework (Diataxis) that provides implicit context separation.
  • Capability inventory: The skill can write to the local file system and execute git and mkdocs CLI tools.
  • Sanitization: Command-line arguments derived from user input (like branch names and URLs) are sanitized using dedicated validation routines to prevent injection attacks.
Audit Metadata
Risk Level
SAFE
Analyzed
Nov 2, 2026, 04:52 PM