Skip to content

gpsaggese/helpers / .claude/skills/blog.create_for_helpers_tool

blog.create_for_helpers_tool

Verified

Write a blog for a tool in helpers

FileKindSize
SKILL.mdskill md2.8 KB
---
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`
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall