skills

my personal agent skills

GitHub: https://github.com/crossoverJie/skills

指标	值
Stars	18
Language	Python
License	Apache-2.0
Topics	agent, ai, skills

README 摘要

name: generate-wiki
description: >
Agent-driven wiki generation workflow for gRPC + Java projects with consistent styling.

⚠️ This skill is optimized for gRPC + Java architecture. It delivers the best results
when the project uses gRPC for service communication and Java as the implementation language.
For other architectures (REST, GraphQL, non-Java languages), the output quality may vary.

Use this skill whenever the user wants to:

Create a documentation wiki for a Java project
Generate API documentation from gRPC proto files
Set up a project wiki with consistent styling
Create interface documentation for microservices

This skill is specifically designed for projects using:

gRPC for service communication
Java as the implementation language
Proto files for API definitions

Do not use for:
- Non-gRPC projects (REST/GraphQL)
- Non-Java projects (Node.js, Python, Go)
- Documentation without code generation needs

Generate Wiki Skill

Role Definition: You are a senior Java architect skilled in:

Analyzing code structure of gRPC + Java microservice projects
Understanding the mapping between proto definitions and Java implementations
Writing clear and accurate technical documentation
Identifying core business logic and key code paths

Agent-driven workflow for generating consistent wiki documentation for gRPC + Java projects.

What This Skill Does

This skill does not parse source code through built-in project-specific scripts.

Instead, it instructs the Agent to:

inspect the repository with code-search and file-reading tools
identify gRPC services, proto definitions, and Java implementations
generate a consistent wiki structure
follow the provided style and output requirements

Important: Not a Generic Wiki Template

This skill provides a framework, not a one-size-fits-all solution. Each project has unique characteristics that require targeted optimization:

Different business domains — e-commerce, fintech, logistics, etc. each have specific documentation needs
Different architectures — even within gRPC + Java, service patterns, middleware usage, and data flows vary
Different team needs — some teams need detailed API specs, others need high-level architecture overviews

You should customize the generated wiki based on:

Your project’s specific business logic and domain terminology
The actual service dependencies and data flows in your codebase
Your team’s documentation standards and review requirements
The level of detail your developers need (API reference vs. architecture guide)

The templates and structure provided are starting points — expect to refine them through multiple iterations with the Agent to match your project’s specific needs.

Required Workflow

See docs/workflow.md for the complete Agent workflow.

Summary

Phase 1: Discovery - Find all components first

Scan - Find ALL proto,

本文基于 GitHub 项目 crossoverJie/skills 整理。

skills — my personal agent skills