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.

templatesoss.md

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

Open Source Project README Template

Use this template for projects intended for public use and contribution.

[Project Name]

[One-line description of what this project does]

License Build Status npm version

About

[2-3 sentences explaining what problem this solves and why someone would use it. Include what makes it different from alternatives if relevant.]

Features

  • [Key feature 1]
  • [Key feature 2]
  • [Key feature 3]

Installation

[package manager install command]

Requirements

  • [Runtime requirement, e.g., Node.js >= 18]
  • [Other dependencies if any]

Usage

[Minimal working example showing the most common use case]

More Examples

[Link to examples directory or additional code samples]

Documentation

[Link to full docs if they exist separately, or expand this section]

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Development Setup

[Commands to clone and set up for development]

Running Tests

[Test command]

Roadmap

  • [Planned feature 1]
  • [Planned feature 2]

Acknowledgments

  • [Credit to inspirations, contributors, or dependencies worth highlighting]

License

[Project name] is licensed under the [License name] license. See the LICENSE file for more information.

Source: SKILL.md on GitHub

Third-party checks

No alerts17d5 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    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.

  • Socket17d

    No alerts

  • Snyk17d

    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.