Agent skill

Weekly Report Writer

by cafe3310 in cafe3310/public-agent-skills

综合 Obsidian 笔记库中的文档,基于最近的文档、上一份报告和项目背景生成周报. An agent skill from cafe3310/public-agent-skills.

Apache-2.0Auto-check passed

Install Weekly Report Writer

skills CLI
$ npx skills add cafe3310/public-agent-skills --skill weekly-report-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cafe3310/public-agent-skills weekly-report-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cafe3310/public-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/weekly-report-writer .claude/skills/weekly-report-writer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
weekly-report-writer
GitHub stars
255
Token cost
~469 tokens
SKILL.md length
105 words
Files
3 (incl. references, assets)
Skills in repo
29
Repo updated
First seen
Licence
Apache-2.0

At a glance

综合 Obsidian 笔记库中的文档,基于最近的文档、上一份报告和项目背景生成周报. An agent skill from cafe3310/public-agent-skills.

  • Works in 7 steps: 开始日期:报告周期的开始。 → 结束日期:报告周期的结束。 → 仓库文件名是否包含日期前缀:确认文件命名约定(如… → …
  • SKILL.md covers 概览, 何时使用 and 工作流
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Weekly Report Writer is an agent skill from cafe3310/public-agent-skills. 综合 Obsidian 笔记库中的文档,基于最近的文档、上一份报告和项目背景生成周报

Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files and assets.

It works with Obsidian. The repository describes itself as: personal agent skills for better QoL. The licence is Apache-2.0.

Example prompts

  • “/weekly-report-writer”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. 开始日期:报告周期的开始。
  2. 结束日期:报告周期的结束。
  3. 仓库文件名是否包含日期前缀:确认文件命名约定(如 YYYY-MM-DD-描述.md)。
  4. 上一份报告路径:上一份周报的文件路径。这对追踪正在进行的任务至关重要。
  5. 笔记库目录:文档存储库的根目录(例如他们的 Obsidian vault 路径)。
  6. (可选)报告模板路径:如果用户有特定模板,请提供其路径。
  7. (可选)项目背景路径:总结更大组织所有项目的文档路径(如果有)。

What it can do on your machine

Read from SKILL.md and the folder at commit 6c45501. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Weekly Report Writer loads about 469 tokens when it runs, and up to ~905 if it reads all its reference files. Until then it costs about 16 tokens; SKILL.md has 105 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~16
When it runs · the whole SKILL.md, loaded when a task matches
~469
With references · SKILL.md plus every file in references/, read only if the agent opens them
~905

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from cafe3310/public-agent-skills at commit 6c45501, republished under its Apache-2.0 licence (© cafe3310). 105 words, ~469 tokens.

Download SKILL.mdSave it as .claude/skills/weekly-report-writer/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
weekly-report-writer
description
综合 Obsidian 笔记库中的文档,基于最近的文档、上一份报告和项目背景生成周报
license
Apache-2.0
author
github/cafe3310

Weekly Report Writer (周报撰写助手)

概览

此技能自动化了周报/双周报的创建过程。它通过查找指定日期范围内的所有相关文档,阅读其内容,并根据模板或分层结构合成信息。它特别注重项目的连续性(追踪上一份报告的任务状态)和内容的深度(通过链接溯源)。

何时使用

当用户要求:

  • “写我的周报”或“起草本周摘要”。
  • 总结两个日期之间的进度。
  • 基于上一份报告和一组新文档创建新报告。

此技能在文档知识库,如 Obsidian 知识库中特别有效。

工作流

遵循此工作流生成报告。

第一步:收集用户输入

在开始之前,与用户确认以下信息:

  1. 开始日期:报告周期的开始。
  2. 结束日期:报告周期的结束。
  3. 仓库文件名是否包含日期前缀:确认文件命名约定(如 YYYY-MM-DD-描述.md)。
  4. 上一份报告路径:上一份周报的文件路径。这对追踪正在进行的任务至关重要。
  5. 笔记库目录:文档存储库的根目录(例如他们的 Obsidian vault 路径)。
  6. (可选)报告模板路径:如果用户有特定模板,请提供其路径。
  7. (可选)项目背景路径:总结更大组织所有项目的文档路径(如果有)。
第二步:查找文档

查找日志:使用用户提供的 笔记库目录 和日期范围,查找日期范围匹配的所有 Markdown 文件。

第三步:与用户确认文件列表

向用户展示找到的文件列表(日志 + 探测到的模板)。请用户确认列表,并反馈任何应 重点关注 或 跳过 的文件。 一般来说,摘抄的文档、语音转写原文日志等应跳过; 每日工作小结、会议纪要、项目更新等应重点关注。 个人 Idea 或 side project 要记录在第一部分的末尾一节。

第四步:阅读、深度溯源与合成

确认后,阅读所有文件的内容。过程中要注意:

几个注意事项:

  • 链接追踪:在阅读每日摘要/日志时,如果遇到一个指向另一个文档的“关键事项”,且包含 [[文档链接]],你应该使用工具读取那个被链接的文档。原因是,每日摘要通常只是一句话(“完成了... ”),而高质量周报需要源文档中的具体产出、方法和数据。
  • 信息合成:过程中,合成信息时要注意:
    • 追踪“上一份报告”中的项目,凸显其进展。
    • 识别待办 (🟥)、已完成 (🟩)、进行中 (🟨) 和新想法 (💡),标记各个事项。
    • 待办继承:上一份报告中任何 🟥 (待办) 或 🟨 (进行中) 的项目,必须 带入新报告的“待办/积压”区域,除非在新报告中已经包括并明确标记为 🟩 (已完成)。
第五步:起草报告 (分层输出)

起草报告。如果在第二步中找到了特定模板,请严格遵循它。否则,使用标准分层结构:

第一部分:个人状态同步

  • 这是个人日志。
  • 受众:自己 / 知识库。
  • 内容:详细的技术背景、指向深度文档的链接、个人思考 (💡) 和具体状态更新。保留 [[Wiki Link]] 格式。

第二部分:团队对外同步

  • 这是团队报告中「自己负责的部分」。
  • 受众:管理者 / 团队。
  • 内容:高层级摘要。
    • 关键进展:交付了什么?(关注价值)。
    • 风险/卡点:需要什么支持?
    • 下一步计划:近期计划是什么?
    • 提及:使用 @用户 格式标记负责人。

报告文件名:使用文档库的文件名定义,和之前的报告文件名风格保持一致。

第六步:遗漏检查 (Gap Analysis)

草稿生成后,针对高价值产出进行一轮“遗漏检查”。提醒用户「检查草稿,若有遗漏,请补充」。然后按用户反馈对草稿做编辑更新。

© cafe3310, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references, assets) in skills/weekly-report-writer of cafe3310/public-agent-skills.

  • SKILL.md
  • assets/weekly_report.md.template
  • references/agents.md.example

Open the folder on GitHubat commit 6c45501

Compare with similar skills

Weekly Report Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Weekly Report Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Weekly Report Writer this skillcafe3310/public-agent-skills255—~469Automated safety check: PassApache-2.0
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0
Knap Markdown Templateskepano/obsidian-skills49k2 repos~986Automated safety check: PassMIT
JSON Canvasheyitsnoah/claudesidian2.6k18 repos~3.5kAutomated safety check: PassMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
Obsidian CLIAtmosphere/atmosphere3.8k13 repos~795Automated safety check: PassApache-2.0

Similar skills

  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Knap Markdown Templates

    kepano/obsidian-skills

    Renders Markdown notes from Knap templates and JSON data on the command line, including notes built from Defuddle web page output.

    49k GitHub starsUsed in 2 repos~986 tokens
    Documents & OfficeAuto-check passed
  • JSON Canvas

    heyitsnoah/claudesidian

    Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections.

    2.6k GitHub starsUsed in 18 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Obsidian CLI

    Atmosphere/atmosphere

    Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

    3.8k GitHub starsUsed in 13 repos~795 tokens
    Knowledge ManagementAuto-check passed
  • Obsidian Canvas Creator

    axtonliu/axton-obsidian-visual-skills

    Create Obsidian Canvas files from text content, supporting both MindMap and freeform layouts.

    3.6k GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed

More from cafe3310/public-agent-skills

All 29 skills in this repo
  • Impeccable

    cafe3310/public-agent-skills

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    255 GitHub stars~4.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Text Watermark Fountain

    cafe3310/public-agent-skills

    A specialized skill for embedding and extracting resilient watermarks in text by manipulating sentence lengths and using Fountain Codes.

    255 GitHub stars~921 tokensUpdated 3 mo ago
    Auto-check passed
  • Obsidian Todo Collector

    cafe3310/public-agent-skills

    从 Obsidian 知识库中扫描指定时间范围内未完成事件,生成/更新未完成事件整理文档. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~575 tokensUpdated 3 mo ago
    Auto-check passed
  • Deep Research

    cafe3310/public-agent-skills

    一个全面、自主的深度研究框架。当用户请求对复杂主题、市场调研、技术格局进行深入的多维度调查,或需要大量网页浏览、数据合成和结构化报告的任何任务时,使用此技能。它协调子代理(subagents)并使用基于文件系统的状态管理来防止上下文膨胀。

    255 GitHub stars~996 tokensUpdated 3 mo ago
    Auto-check passed
  • Long Audio To Obsidian

    cafe3310/public-agent-skills

    将语音转写项目输出的复杂文件结构整理合并为适合 Obsidian 归档的 Markdown 文档. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~772 tokensUpdated 3 mo ago
    Auto-check passed
  • Markdown New

    cafe3310/public-agent-skills

    通过 markdown.new API 将网页、整站或搜索结果转换为干净的 Markdown. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~344 tokensUpdated 3 mo ago
    Auto-check passed

Works with

Questions about Weekly Report Writer

What does Weekly Report Writer do?

综合 Obsidian 笔记库中的文档,基于最近的文档、上一份报告和项目背景生成周报. An agent skill from cafe3310/public-agent-skills. Weekly Report Writer is an agent skill from cafe3310/public-agent-skills.

How do I install Weekly Report Writer in Claude Code?

Run `npx skills add cafe3310/public-agent-skills --skill weekly-report-writer -a claude-code`. Or copy the skill folder (skills/weekly-report-writer in cafe3310/public-agent-skills) into .claude/skills/weekly-report-writer in your project. Claude Code loads it when a task matches its description.

How do I install Weekly Report Writer in Codex?

Run `npx skills add cafe3310/public-agent-skills --skill weekly-report-writer -a codex`. Or copy the skill folder (skills/weekly-report-writer in cafe3310/public-agent-skills) into .agents/skills/weekly-report-writer in your project. Codex loads it when a task matches its description.

Can I use Weekly Report Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cafe3310/public-agent-skills --skill weekly-report-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/weekly-report-writer, .gemini/skills/weekly-report-writer, .github/skills/weekly-report-writer and .opencode/skills/weekly-report-writer in your project.

What does Weekly Report Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Weekly Report Writer is instructions for the agent only.

Does Weekly Report Writer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Weekly Report Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Weekly Report Writer use?

Weekly Report Writer is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Weekly Report Writer use?

About 469 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 436 tokens, read only when the agent opens those files.

What are the alternatives to Weekly Report Writer?

Skills that share tags, products or a category with Weekly Report Writer: Obsidian Bases (Atmosphere/atmosphere, 3.8k stars), Knap Markdown Templates (kepano/obsidian-skills, 49k stars), JSON Canvas (heyitsnoah/claudesidian, 2.6k stars) and Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Weekly Report Writer?

cafe3310 (a GitHub user) maintains it in cafe3310/public-agent-skills, which has 255 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on June 26, 2026.

Source: cafe3310/public-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.