generate-weekly-report

What This Skill Does

The generate-weekly-report skill is a high-efficiency automation tool designed for software development teams and technical leads. It acts as an intelligent summarizer that parses Git commit logs from local project directories and transforms raw, often fragmented commit messages into clean, structured, and professional weekly reports. By analyzing commit history across multiple projects simultaneously, it organizes updates into logical functional modules, stripping away the technical noise to highlight actual progress made during the week.

Installation

To integrate this skill into your environment, ensure you have the OpenClaw agent installed and configured. Open your terminal and run the following command:

clawhub install openclaw/skills/skills/anneheartrecord/weekly-report-generator-by-git

Ensure that you have Git installed on your system and that the target project directories are accessible, as the skill relies on the local execution of the scripts/get_git_log.sh helper to retrieve the log data.

Use Cases

This skill is perfect for:

• Software engineers needing to draft their weekly progress reports quickly.
• Engineering managers who need to aggregate status updates across multiple repositories for team meetings.
• Freelancers maintaining a clean record of project velocity for client communication.
• Teams moving toward automated project documentation workflows, reducing the manual burden of weekly reporting.

Example Prompts

1. "Analyze the Git logs from my project directory and generate this week's progress report using the weekly-report-generator skill."
2. "I have three projects in the current workspace. Please aggregate all commits from this week into a single organized weekly report."
3. "Summarize the last 7 days of development activity in the current repo and categorize them by functional module."

Tips & Limitations

• Quality of Commits: The quality of the generated report is directly proportional to your commit message habits. Using Conventional Commits (e.g., "feat: add login", "fix: resolve crash") will significantly improve the AI's ability to categorize your work.
• Scope: Currently, the skill is designed to process local git logs via the provided bash script. Ensure your local environment has read permissions for the repository directories.
• Manual Cleanup: While the AI simplifies and summarizes messages, it is best practice to perform a quick final review of the generated report before sending it to stakeholders to ensure professional tone accuracy.