gpsaggese/helpers / .claude/skills/blog.create_for_helpers_tool
blog.create_for_helpers_tool
VerifiedWrite a blog for a tool in helpers
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.8 KB |
SKILL.md
View on GitHub---
description: Write a blog for a tool in helpers
model: haiku
---
# Goal
- Given a tool `<TOOL>` in `helpers`, 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`
- the testing code
- E.g., `helpers/test/test_hcache_simple.py`
- README describing the tool
- E.g., `docs/tools/helpers/all.hcache_simple.explanation.md`
- Notebooks and tutorials
- E.g., `helpers/notebooks/hcache_simple.tutorial.ipynb`
## Write the Blog Text
- Follow this file format:
```markdown
# 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`
```markdown
# 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:
```markdown
<!-- Generated by `.claude/skills/blog.create_for_helpers_tool/SKILL.md` -->
```
## Format
- At the end, format the text with
```bash
> 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.sh` ran 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: 198k | 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: 194k | 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: 194k | 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: 194k | Updated | Claude CodeCodex | Verified | Install |