Skip to content
Back to skills

Docs

ASecurity

Generate full SDLC documentation suites and compile interactive HTML presentations. Trigger via /docs.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added September 3, 2026
ai-agentspythongobashfastapiapidocumentation

Works with

  • api

Security analysis

A100/100

Pro scans all 6 files and shows the line behind each finding

Scanned September 3, 2026

npx -y skills add ksprashu/agent-skill-forge --skill docs --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Docs?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Docs
[![Security: A β€” Skills Directory](https://www.skillsdirectory.com/api/skills/ksprashu-docs/badge)](https://www.skillsdirectory.com/skills/ksprashu-docs)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: docs
description: Generate full SDLC documentation suites and compile interactive HTML presentations. Trigger via /docs.
disable-model-invocation: true
---

# Docs: SDLC Documentation & HTML Presentation Compiler

Scaffold standard SDLC documentation suites and compile markdown files into interactive, single-file HTML presentations.

---

## 🎯 Goal
Produce structured markdown documentation (PRDs, specs, user guides, architecture docs) and compile them into standalone HTML presentation portals with 4 themes (`technical`, `obsidian`, `proscript`, `dynamics`).

---

## πŸ“‹ Step-by-Step Workflow

1. **Scaffold Markdown Docs**: Author documents in `docs/` (`user_guide.md`, `architecture.md`, `prd_feature_doc.md`).
2. **Dual-Link Grounding**: Include both product and official documentation links for all referenced technologies.
3. **Declare Theme in Frontmatter**: Specify `theme: "technical"` (or `obsidian`, `proscript`, `dynamics`).
4. **Compile to HTML**: Run the compiler script:
   ```bash
   python3 scripts/compile_docs.py --dir ./docs
   # Or compile a single file:
   python3 scripts/compile_docs.py --file ./README.md --theme obsidian
   ```
5. **Verify Tag Balance**: Ensure all HTML containers and table layouts are cleanly closed and responsive.

---

## πŸ’‘ Concrete Example

### Markdown Frontmatter & Dual-Linking Fixture
```markdown
---
title: "Developer Integration Guide"
theme: "technical"
description: "Step-by-step API integration guide"
---

# Developer Integration Guide

Integrate with [FastAPI](https://fastapi.tiangolo.com) ([Docs](https://fastapi.tiangolo.com/tutorial/)) and deploy to [Google Cloud Run](https://cloud.google.com/run) ([Docs](https://cloud.google.com/run/docs)).

## πŸ“š References & Further Reading
* [FastAPI Official Docs](https://fastapi.tiangolo.com/)
* [Google Cloud Run Documentation](https://cloud.google.com/run/docs)
```

---

## 🚫 Hard Constraints

*   **NEVER** leave unmatched HTML tags (`<div>` without `</div>`).
*   **NEVER** mention third-party tools/libraries without providing official documentation links.
*   **NEVER** use dark/light themes with unreadable text contrast.

Files in this skill

  • README.md419 B
  • SKILL.md2.1 KB
  • examples/sample_guide.html26.9 KB
  • examples/sample_guide.md2.6 KB
  • scripts/compile_docs.py29.8 KB
  • scripts/watch_docs.py5.4 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…