acc-readme-template

📁 dykyi-roman/awesome-claude-code 📅 2 days ago

总安装量

周安装量

#54385

全站排名

安装命令

npx skills add https://github.com/dykyi-roman/awesome-claude-code --skill acc-readme-template

Agent 安装分布

opencode 1

claude-code 1

Skill 文档

README Template Generator

Generate professional README.md files for PHP projects.

Template Structure

# {Project Name}

{badges}

{one-line description}

## Features

{feature list with benefits}

## Requirements

{dependencies and versions}

## Installation

{composer command and setup steps}

## Quick Start

{minimal working example}

## Documentation

{links to detailed docs}

## Contributing

{link to CONTRIBUTING.md}

## Changelog

{link to CHANGELOG.md}

## License

{license type and link}

Badge Templates

Standard Badge Set

[![CI](https://github.com/{owner}/{repo}/actions/workflows/ci.yml/badge.svg)](https://github.com/{owner}/{repo}/actions)
[![Coverage](https://codecov.io/gh/{owner}/{repo}/graph/badge.svg)](https://codecov.io/gh/{owner}/{repo})
[![Packagist](https://img.shields.io/packagist/v/{vendor}/{package}.svg)](https://packagist.org/packages/{vendor}/{package})
[![PHP](https://img.shields.io/packagist/php-v/{vendor}/{package}.svg)](https://packagist.org/packages/{vendor}/{package})
[![License](https://img.shields.io/github/license/{owner}/{repo}.svg)](LICENSE)

Minimal Badge Set

[![Build](https://img.shields.io/github/actions/workflow/status/{owner}/{repo}/ci.yml)](https://github.com/{owner}/{repo}/actions)
[![Version](https://img.shields.io/packagist/v/{vendor}/{package})](https://packagist.org/packages/{vendor}/{package})

Section Templates

Features Section

## Features

- â **Feature Name** â Brief description of benefit
- â **Feature Name** â Brief description of benefit
- â **Feature Name** â Brief description of benefit
- ð§ **Coming Soon** â Planned feature

Requirements Section

## Requirements

- PHP 8.5+
- Composer 2.0+
- Extensions: ext-json, ext-pdo

### Optional

- Redis (for caching)
- RabbitMQ (for queuing)

Installation Section (Basic)

## Installation

```bash
composer require {vendor}/{package}


### Installation Section (With Config)

```markdown
## Installation

1. Install via Composer:

```bash
composer require {vendor}/{package}

Publish configuration (optional):

php artisan vendor:publish --provider="Vendor\Package\ServiceProvider"

Configure environment:

# .env
PACKAGE_API_KEY=your-key
PACKAGE_DEBUG=false


### Quick Start Section

```markdown
## Quick Start

```php
<?php

declare(strict_types=1);

use {Vendor}\{Package}\{MainClass};

// Initialize
${instance} = new {MainClass}();

// Basic operation
$result = ${instance}->doSomething('input');

// Output
echo $result->status; // "success"


### Documentation Section

```markdown
## Documentation

- ð [Getting Started](docs/getting-started.md)
- âï¸ [Configuration](docs/configuration.md)
- ð [API Reference](docs/api/README.md)
- ð¡ [Examples](docs/examples/)
- â [FAQ](docs/faq.md)

Contributing Section

## Contributing

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for:

- Development setup
- Coding standards
- Testing guidelines
- Pull request process

License Section

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

Complete Example

# Awesome Package

[![CI](https://github.com/vendor/awesome-package/actions/workflows/ci.yml/badge.svg)](https://github.com/vendor/awesome-package/actions)
[![Coverage](https://codecov.io/gh/vendor/awesome-package/graph/badge.svg)](https://codecov.io/gh/vendor/awesome-package)
[![Packagist](https://img.shields.io/packagist/v/vendor/awesome-package.svg)](https://packagist.org/packages/vendor/awesome-package)
[![PHP](https://img.shields.io/packagist/php-v/vendor/awesome-package.svg)](https://packagist.org/packages/vendor/awesome-package)
[![License](https://img.shields.io/github/license/vendor/awesome-package.svg)](LICENSE)

A PHP library for processing awesome things with type safety and modern practices.

## Features

- â **Type-Safe API** â Full PHP 8.5 type declarations
- â **PSR Compliant** â PSR-4, PSR-7, PSR-12
- â **Zero Dependencies** â No external runtime dependencies
- â **Fully Tested** â 100% code coverage

## Requirements

- PHP 8.5+
- Composer 2.0+
- ext-json

## Installation

```bash
composer require vendor/awesome-package

Quick Start

<?php

declare(strict_types=1);

use Vendor\AwesomePackage\Processor;

$processor = new Processor();
$result = $processor->process(['data' => 'value']);

echo $result->status; // "success"

Documentation

Contributing

See CONTRIBUTING.md for development setup and guidelines.

Changelog

See CHANGELOG.md for version history.

License

MIT License – see LICENSE for details.


## Generation Instructions

When generating a README:

1. **Analyze** the project structure (`composer.json`, `src/`)
2. **Identify** main class/entry point
3. **Extract** dependencies and requirements
4. **Create** minimal working example
5. **Generate** appropriate badges
6. **Link** to existing documentation
7. **Verify** all links point to existing files

GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台