docs-writer
Documentation workflow that converts requirements into structured AsciiDoc sections, runs Vale for style compliance, and produces merge-ready content. Use when creating or updating AsciiDoc documentation from Jira tickets, GitHub issues, or feature descriptions.
94
Quality
92%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Security
2 findings — 2 medium severity. This skill can be installed but you should review these findings before use.
W011: Third-party content exposure detected (indirect prompt injection risk)
What this means
The skill exposes the agent to untrusted, user-generated content from public third-party sources, creating a risk of indirect prompt injection. This includes browsing arbitrary URLs, reading social media posts or forum comments, and analyzing content from unknown websites.
Why it was flagged
Third-party content exposure detected (high risk: 1.00). The gather-context skill (see skills/gather-context.md and controller.md) explicitly fetches Jira tickets and GitHub issues/PR diffs via Jira MCP or the gh CLI, ingests user-generated issue bodies, comments, and PR diffs into .artifacts/${ticket_id}/01-context.md, and the workflow uses that content to drive planning, drafting, validation, and repository changes — meaning untrusted third‑party content is read and can materially influence agent actions.
W012: Unverifiable external dependency detected (runtime URL that controls agent)
What this means
The skill fetches instructions or code from an external URL at runtime, and the fetched content directly controls the agent’s prompts or executes code. This dynamic dependency allows the external source to modify the agent’s behavior without any changes to the skill itself.
Why it was flagged
Potentially malicious external URL detected (high risk: 0.80). The gather skill explicitly fetches GitHub issues and PR diffs at runtime (e.g., using gh pr diff) from the upstream repository https://github.com/flightctl/flightctl, and those fetched diffs are ingested as source material that directly drives the agent's synthesized context and outputs.
- Repository
- amir-yogev-gh/ai-workflows
- Commit
b213ece
- Audited
- Security analysis
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.