skilld
All skills
softaworks avatar

/crafting-effective-readmes

@1c0662a
by softaworkssoftaworks/agent-toolkit2.5k stars
230

Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.

Ask your Agent

Use this Skill: https://skilld.dev/gh/softaworks/agent-toolkit/crafting-effective-readmes

This session only. Nothing lands on disk.

section-checklist.md

≈170 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Section Checklist by Project Type

Quick reference for which sections to include based on project type.

Section OSS Personal Internal Config
Name/Description Yes Yes Yes Yes
Badges Yes Optional No No
Installation Yes Yes Yes No
Usage/Examples Yes Yes Yes Brief
What's Here No No No Yes
How to Extend No No Optional Yes
Contributing Yes Optional Yes No
License Yes Optional No No
Architecture Optional No Yes No
Gotchas/Notes Optional Optional Yes Yes
Last Reviewed No No Optional Yes

Source: SKILL.md on GitHub

Third-party checks

No alerts16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill is a collection of Markdown templates and documentation guidelines designed to help generate README files. It contains no executable code, automation scripts, or sensitive data access patterns.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer7mo

    14 files scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 1c0662a. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Dormantupdated 9 months ago

Topics

  • Documentation
  • readme
  • templates
  • open-source
  • contributing
  • project-setup
  • technical-writing

README badge

README badge for softaworks/agent-toolkit/crafting-effective-readmes

What it does

This skill guides you through writing or updating README files by identifying your audience and task type, then providing templates and section checklists matched to whether you're documenting an open source project, internal tool, personal project, or config folder.

Generated from the current SKILL.md.

Frequently asked

Does this skill work for all project types?
Yes. The skill includes templates and guidance for open source, personal projects, internal tools, and config folders. Ask the skill which project type you're working on if it's not clear.
Can this skill help update an existing README?
Yes. The skill can identify stale sections by comparing your README to the actual project state (package.json, main files, etc.) and propose specific edits.
Does this skill provide templates?
Yes. It includes templates for OSS projects, personal projects, internal tools, and config folders, plus a section checklist and style guide.
What if I'm not sure what type of README I'm writing?
The skill asks you to identify your audience first — contributors, teammates, future you, or portfolio viewers — and matches guidance to that audience rather than assuming defaults.

Generated from the current SKILL.md. These answers refresh after source changes.