gpsaggese/helpers / .claude/skills/blog.create_for_helpers_tool
blog.create_for_helpers_tool
VerifiedWrite a blog for a tool in helpers
Goal
- Given a tool
<TOOL>inhelpers, write a short blog presenting this tool
Workflow
Read and Follow the Rules to Write a Blog
-
Read the rules in
.claude/skills/blog.rules.md -
Follow these rules when writing:
.claude/skills/markdown.rules.md.claude/skills/text.rules.md
Gather Source Material
- Find related docs, such as
- the source code
- E.g.,
helpers/hcache_simple.py
- E.g.,
- the testing code
- E.g.,
helpers/test/test_hcache_simple.py
- E.g.,
- README describing the tool
- E.g.,
docs/tools/helpers/all.hcache_simple.explanation.md
- E.g.,
- Notebooks and tutorials
- E.g.,
helpers/notebooks/hcache_simple.tutorial.ipynb
- E.g.,
- the source code
Write the Blog Text
-
Follow this file format:
# Introduction ## What Is ...? ## When To Use ...? ## When NOT To Use ...? # How It Works # Real-World Scenarios ## Scenario 1: ... ## Scenario 2: ... # Advanced Features ## ... # Comparison with Alternatives # References ## Add references to the files in the repo -
E.g., for
hcache_simple.py# Introduction ## What Is `hcache_simple`? ## The Three Cache Layers ## When To Use `hcache_simple` ## When NOT To Use `hcache_simple` # How It Works # Real-World Scenarios ## Scenario 1: Caching LLM Calls ## Scenario 2: Binary Data Caching with Pickle ## Scenario 3: Per-Function Cache Organization # Advanced Features ## Performance Monitoring ## Source-Change Detection ## Global Caching Controls ## Mock Cache for Testing # Comparison with Alternatives # References
Reference GitHub Files
- When referring to repo files, follow
.claude/skills/blog.rules.md## References to GitHub Files
Add Visuals
- Add visuals following
.claude/skills/blog.rules.md# Visuals## Add Visuals to Blog Posts: suggestions## Types of Visuals: types of visuals (such as mermaid, graphviz, tikz, images, website screenshots)
Write File
- Name the file
website/docs/blog/posts/draft.in_<INT>_mins.helpers_<TOOL>.md, where<INT>is the reading time (e.g., 5 mins, 15 mins, 30 mins) based on complexity - Add this comment after the front matter to say how the blog was generated:
<!-- Generated by `.claude/skills/blog.create_for_helpers_tool/SKILL.md` -->
Format
- At the end, format the text with
> website/format_blog.sh <BLOG_FILE>
Verification
- Confirm the file name matches
website/docs/blog/posts/draft.in_<INT>_mins.helpers_<TOOL>.md - Confirm the blog follows the section structure in
## Write the Blog Text - Confirm
website/format_blog.shran without errors - The blog file says that it was generated by
.claude/skills/blog.create_for_helpers_tool/SKILL.md
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |