medium-article-from-repolisted
Install: claude install-skill simonlivson/claude-skills
# Medium article from a repo
## When to use
- The user names a repo, a project folder, or a finished bootcamp project and asks for an article or write-up.
## Inputs
- The repo (README, code, results files, notebooks). Required.
- Target reader (default: people learning AI/ML, and hiring managers).
- Any angle or length the user wants (default 700 to 1,000 words).
## Steps
1. **Collect facts from the repo only:** goal, data, method, tools, and every number in READMEs, result files and notebook outputs. Write each number with the file it came from.
2. **Find the honest story:** what the result was, what surprised, what failed or was limited (small sample, ceiling effects, untested cases).
3. **Outline** and show it before drafting long text if the user wants to steer:
- Title: plain and specific, with the result if there is one.
- Opening (2 to 3 sentences): the result first, with the number.
- The problem and why it matters.
- How it was built: data, method, tools, in steps.
- Results: a small table or bullets with the exact numbers.
- What didn't work and the limits.
- What's next.
- Link to the repo.
4. **Draft** in the user's voice: short sentences, first person, plain words.
5. **Fact table:** after the draft, list every number and claim with its source file.
## Output format
- Markdown article ready to paste into Medium, then a "Facts used" table (claim, value, source file).
## Guardrails
- Draft only. Never publish, schedule or post a link to