Skip to content

trsoliu/mini-wiki

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Mini-Wiki Banner

skills.sh compatible Version License GitHub Stars

Transform your codebase into professional-grade, structured documentation with AI πŸš€

πŸ“– δΈ­ζ–‡ζ–‡ζ‘£ Β· πŸ› Report Bug Β· ✨ Request Feature


✨ What is Mini-Wiki?

Mini-Wiki is a skills.sh compatible skill package that empowers AI Agents to deeply analyze your codebase and generate professional-grade, structured Wiki documentation with diagrams, cross-links, and detailed explanations β€” effortlessly.

πŸ’‘ Before Mini-Wiki

  • Writing docs manually is tedious πŸ“
  • Documentation gets outdated quickly 😩
  • No architecture diagrams πŸ“Š
  • Code references are disconnected πŸ”—

πŸŽ‰ After Mini-Wiki

  • AI generates professional-grade docs ✨
  • Incremental updates keep docs fresh πŸ”„
  • Beautiful Mermaid diagrams πŸ“ˆ
  • Code blocks link to source 🎯
  • Deep code analysis for detailed content πŸ”¬
  • Cross-linked documentation network πŸ”—

🎯 Features

Smart Analysis
πŸ” Smart Analysis
Auto-detect tech stack and module structure
Incremental Update
πŸ”„ Incremental Update
Only update docs for changed files
Architecture
πŸ“Š Architecture Diagrams
Auto-generate Mermaid dependency graphs
Code Links
πŸ”— Code Links
Code blocks link directly to source
Multi-language
🌐 Multi-language
Support Chinese and English Wiki
Plugin System
πŸ”Œ Plugin System
Extend with custom plugins

πŸš€ Quick Start

Installation

Choose your preferred method:

πŸ“¦ Option 1: Using npx (Recommended)
npx skills add trsoliu/mini-wiki
πŸ“₯ Option 2: Download .skill file

Download mini-wiki.skill from Releases and place it in your skills directory.

πŸ“‚ Option 3: Clone repository
git clone https://github.com/trsoliu/mini-wiki.git

Usage

Simply tell your AI Agent:

πŸ€– "generate wiki"
πŸ€– "create project docs"  
πŸ€– "update wiki"

Plugin Commands

# Natural Language
πŸ“‹ "list plugins"
πŸ“¦ "install plugin <source>"
πŸ“¦ "install <owner/repo>"  (GitHub shorthand)
πŸ”„ "update plugin <name>"
βœ… "enable plugin <name>"
❌ "disable plugin <name>"

# CLI Direct Usage
python scripts/plugin_manager.py list
python scripts/plugin_manager.py install <source>
python scripts/plugin_manager.py update <name>
python scripts/plugin_manager.py enable <name>

Installation Sources:

  • GitHub: owner/repo (e.g., vercel-labs/agent-skills)
  • URL: https://example.com/plugin.zip
  • Local: ./plugins/my-plugin

How Plugins Work

Mini-Wiki uses an Instruction-based Plugin System. When you run a task:

  1. AI reads plugins/_registry.yaml
  2. AI reads instructions from PLUGIN.md of enabled plugins
  3. AI executes plugin logic at specific Hooks (e.g., before_generate, on_export)

Built-in Plugins

  • code-complexity: Code health & complexity analysis
  • paper-drafter: Generate academic paper drafts (LaTeX/IMRaD)
  • repo-analytics: Multi-dimensional Git analytics & health scoring
  • patent-generator: Professional patent disclosure generator
  • api-doc-enhancer: Deep semantic API documentation
  • changelog-generator: Generate changelog from git
  • diagram-plus: Enhanced Mermaid diagrams
  • i18n-sync: Multi-language sync
  • docusaurus-exporter: Export to Docusaurus
  • gitbook-exporter: Export to GitBook

πŸ“ Output Structure

All content is generated to .mini-wiki/ directory:

.mini-wiki/
β”œβ”€β”€ πŸ“„ config.yaml           # Configuration
β”œβ”€β”€ πŸ“‚ cache/                 # Incremental cache
β”œβ”€β”€ πŸ“‚ wiki/                  # Wiki content
β”‚   β”œβ”€β”€ index.md
β”‚   β”œβ”€β”€ architecture.md
β”‚   β”œβ”€β”€ modules/
β”‚   └── api/
└── πŸ“‚ i18n/                  # Multi-language support
    β”œβ”€β”€ en/
    └── zh/

πŸ—οΈ Skill Structure

mini-wiki/
β”œβ”€β”€ πŸ“„ SKILL.md              # Main instructions (English)
β”œβ”€β”€ πŸ“‚ scripts/              # Python utilities
β”œβ”€β”€ πŸ“‚ references/           # Prompts, templates, i18n
β”œβ”€β”€ πŸ“‚ assets/               # Config templates
└── πŸ“‚ plugins/              # Plugin directory
    β”œβ”€β”€ _registry.yaml
    └── _example/

πŸ™ Inspired By

DeepWiki
DeepWiki
OpenRepoWiki
OpenRepoWiki
Qoder
Qoder Repo Wiki

πŸ“„ License

This project is licensed under the Apache-2.0 License.


πŸ’¬ Contact

Mini-Wiki Logo

Made with ❀️ by trsoliu

GitHub

WeChat: trsoliu

WeChat QR

⭐ Star this repo if you find it helpful! ⭐

About

Open Source Skills Wiki: AI-Powered skills Wiki Generator for GitHub/Gitlab/Bitbucket Repositories.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages