本文へ移動
cccskills
無料GitHub で公開

readme-generator

Generates comprehensive README files with badges, installation, usage, API docs, and contribution guidelines. Use when users request "README", "project documentation", "readme template", "documentation generator", or "project setup docs".

sathishssj3/Stereix-Engine
インストール方法を見る

含まれるファイル（1）

  • SKILL.md12.8 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

README Generator

Create comprehensive, professional README documentation for projects.

Core Workflow

  1. Analyze project: Identify type and features
  2. Add header: Title, badges, description
  3. Document setup: Installation and configuration
  4. Show usage: Examples and API
  5. Add guides: Contributing, license
  6. Include extras: Screenshots, roadmap

README Template

# Project Name

[![npm version](https://img.shields.io/npm/v/package-name.svg)](https://www.npmjs.com/package/package-name)
[![Build Status](https://github.com/username/repo/workflows/CI/badge.svg)](https://github.com/username/repo/actions)
[![Coverage](https://codecov.io/gh/username/repo/branch/main/graph/badge.svg)](https://codecov.io/gh/username/repo)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)

Brief description of what this project does and who it's for. One to two sentences that capture the essence of the project.

## Features

- ✨ Feature one with brief description
- 🚀 Feature two with brief description
- 🔒 Feature three with brief description
- 📦 Feature four with brief description

## Demo

![Demo GIF](https://example.com/demo.gif)

[Live Demo](https://demo.example.com) | [Documentation](https://docs.example.com)

## Quick Start

\`\`\`bash
npx create-project-name my-app
cd my-app
npm run dev
\`\`\`

## Installation

### Prerequisites

- Node.js 18.0 or higher
- npm 9.0 or higher (or pnpm/yarn)

### Package Manager

\`\`\`bash
# npm
npm install package-name

# pnpm
pnpm add package-name

# yarn
yarn add package-name
\`\`\`

### From Source

\`\`\`bash
git clone https://github.com/username/repo.git
cd repo
npm install
npm run build
\`\`\`

## Usage

### Basic Usage

\`\`\`typescript
import { something } from 'package-name';

const result = something({
  option1: 'value',
  option2: true,
});

console.log(result);
\`\`\`

### Advanced Usage

\`\`\`typescript
import { createClient, type Config } from 'package-name';

const config: Config = {
  apiKey: process.env.API_KEY,
  timeout: 5000,
  retries: 3,
};

const client = createClient(config);

// Async operation
const data = await client.fetch('/endpoint');
\`\`\`

### With React

\`\`\`tsx
import { Provider, useData } from 'package-name/react';

function App() {
  return (
    <Provider apiKey={process.env.API_KEY}>
      <MyComponent />
    </Provider>
  );
}

function MyComponent() {
  const { data, loading, error } = useData('key');

  if (loading) return <Spinner />;
  if (error) return <Error message={error.message} />;

  return <div>{data.value}</div>;
}
\`\`\`

## API Reference

### `createClient(config)`

Creates a new client instance.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `apiKey` | `string` | required | Your API key |
| `baseUrl` | `string` | `'https://api.example.com'` | API base URL |
| `timeout` | `number` | `30000` | Request timeout in ms |
| `retries` | `number` | `3` | Number of retry attempts |

**Returns:** `Client`

### `client.fetch(endpoint, options?)`

Fetches data from the specified endpoint.

\`\`\`typescript
const data = await client.fetch('/users', {
  method: 'GET',
  headers: { 'X-Custom': 'value' },
});
\`\`\`

### `client.create(endpoint, data)`

Creates a new resource.

\`\`\`typescript
const user = await client.create('/users', {
  name: 'John Doe',
  email: 'john@example.com',
});
\`\`\`

## Configuration

### Environment Variables

| Variable | Description | Required |
|----------|-------------|----------|
| `API_KEY` | Your API key | Yes |
| `API_URL` | Custom API URL | No |
| `DEBUG` | Enable debug mode | No |

### Configuration File

Create a `config.json` in your project root:

\`\`\`json
{
  "apiKey": "your-api-key",
  "environment": "production",
  "features": {
    "caching": true,
    "logging": false
  }
}
\`\`\`

## Examples

### Example 1: Basic CRUD

\`\`\`typescript
// Create
const user = await client.create('/users', { name: 'John' });

// Read
const users = await client.fetch('/users');

// Update
await client.update(\`/users/\${user.id}\`, { name: 'Jane' });

// Delete
await client.delete(\`/users/\${user.id}\`);
\`\`\`

### Example 2: Error Handling

\`\`\`typescript
try {
  const data = await client.fetch('/protected');
} catch (error) {
  if (error instanceof AuthError) {
    console.error('Authentication failed');
  } else if (error instanceof NetworkError) {
    console.error('Network error:', error.message);
  } else {
    throw error;
  }
}
\`\`\`

More examples in the [examples directory](./examples).

## Architecture

\`\`\`
src/
├── client/          # Client implementation
├── hooks/           # React hooks
├── utils/           # Utility functions
├── types/           # TypeScript types
└── index.ts         # Main export
\`\`\`

## Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

### Development Setup

\`\`\`bash
# Clone the repository
git clone https://github.com/username/repo.git

# Install dependencies
npm install

# Run tests
npm test

# Start development
npm run dev
\`\`\`

### Commit Convention

We use [Conventional Commits](https://www.conventionalcommits.org/):

- `feat:` New feature
- `fix:` Bug fix
- `docs:` Documentation
- `test:` Tests
- `chore:` Maintenance

## Roadmap

- [x] Initial release
- [x] TypeScript support
- [ ] React Native support
- [ ] Offline mode
- [ ] Plugin system

See the [open issues](https://github.com/username/repo/issues) for a full list of proposed features.

## FAQ

<details>
<summary><strong>How do I get an API key?</strong></summary>

Visit [our dashboard](https://dashboard.example.com) to create an account and generate an API key.
</details>

<details>
<summary><strong>Is there a rate limit?</strong></summary>

Yes, the free tier allows 1000 requests per hour. See our [pricing page](https://example.com/pricing) for higher limits.
</details>

<details>
<summary><strong>Does it work with Next.js?</strong></summary>

Yes! We have full support for Next.js including App Router and Server Components.
</details>

## Troubleshooting

### Common Issues

**Error: API key is invalid**

Make sure your API key is correctly set in the environment variables and hasn't expired.

**Error: Network timeout**

Increase the timeout value in your configuration or check your network connection.

## Changelog

See [CHANGELOG.md](CHANGELOG.md) for a history of changes.

## License

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

## Acknowledgments

- [Library 1](https://example.com) - For the amazing feature
- [Library 2](https://example.com) - For inspiration
- All our [contributors](https://github.com/username/repo/graphs/contributors)

## Support

- 📧 Email: support@example.com
- 💬 Discord: [Join our community](https://discord.gg/example)
- 🐦 Twitter: [@username](https://twitter.com/username)
- 📖 Documentation: [docs.example.com](https://docs.example.com)

---

Made with ❤️ by [Your Name](https://github.com/username)

Badge Examples

<!-- Build Status -->
[![CI](https://github.com/user/repo/actions/workflows/ci.yml/badge.svg)](https://github.com/user/repo/actions/workflows/ci.yml)

<!-- npm -->
[![npm](https://img.shields.io/npm/v/package.svg)](https://www.npmjs.com/package/package)
[![npm downloads](https://img.shields.io/npm/dm/package.svg)](https://www.npmjs.com/package/package)

<!-- Coverage -->
[![codecov](https://codecov.io/gh/user/repo/branch/main/graph/badge.svg)](https://codecov.io/gh/user/repo)

<!-- License -->
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

<!-- Language -->
[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
[![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=black)](https://developer.mozilla.org/en-US/docs/Web/JavaScript)

<!-- Framework -->
[![React](https://img.shields.io/badge/React-20232A?logo=react&logoColor=61DAFB)](https://reactjs.org/)
[![Next.js](https://img.shields.io/badge/Next.js-000000?logo=next.js&logoColor=white)](https://nextjs.org/)
[![Node.js](https://img.shields.io/badge/Node.js-339933?logo=node.js&logoColor=white)](https://nodejs.org/)

<!-- Package Manager -->
[![pnpm](https://img.shields.io/badge/pnpm-F69220?logo=pnpm&logoColor=white)](https://pnpm.io/)

<!-- PRs Welcome -->
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)

<!-- Maintenance -->
[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/user/repo/graphs/commit-activity)

<!-- Custom Shields.io -->
[![Custom Badge](https://img.shields.io/badge/custom-badge-blue)](https://example.com)

CONTRIBUTING.md Template

# Contributing to Project Name

Thank you for your interest in contributing! This document provides guidelines and steps for contributing.

## Code of Conduct

Please read and follow our [Code of Conduct](CODE_OF_CONDUCT.md).

## How Can I Contribute?

### Reporting Bugs

- Check existing issues first
- Use the bug report template
- Include reproduction steps
- Provide environment details

### Suggesting Features

- Check existing feature requests
- Use the feature request template
- Explain the use case
- Consider implementation approach

### Pull Requests

1. Fork the repository
2. Create a feature branch: `git checkout -b feature/my-feature`
3. Make your changes
4. Write/update tests
5. Run the test suite: `npm test`
6. Commit with conventional commits: `git commit -m 'feat: add new feature'`
7. Push to your fork: `git push origin feature/my-feature`
8. Open a Pull Request

## Development Setup

\`\`\`bash
# Clone your fork
git clone https://github.com/your-username/repo.git

# Add upstream remote
git remote add upstream https://github.com/original-owner/repo.git

# Install dependencies
npm install

# Create a branch
git checkout -b feature/my-feature
\`\`\`

## Coding Standards

- Follow existing code style
- Use TypeScript strict mode
- Write meaningful commit messages
- Add tests for new features
- Update documentation as needed

## Testing

\`\`\`bash
# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run specific test file
npm test -- path/to/test.ts
\`\`\`

## Questions?

Feel free to open an issue or reach out on Discord.

CHANGELOG.md Template

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added
- New feature description

### Changed
- Change description

### Fixed
- Bug fix description

## [1.2.0] - 2024-01-15

### Added
- Add new authentication method
- Add TypeScript support for config files

### Changed
- Improve error messages
- Update dependencies

### Fixed
- Fix memory leak in connection pool
- Fix race condition in cache invalidation

## [1.1.0] - 2024-01-01

### Added
- Add retry mechanism for failed requests
- Add timeout configuration option

### Deprecated
- Deprecate `oldMethod()` in favor of `newMethod()`

## [1.0.0] - 2023-12-15

### Added
- Initial release
- Core API functionality
- React hooks
- TypeScript types

[Unreleased]: https://github.com/user/repo/compare/v1.2.0...HEAD
[1.2.0]: https://github.com/user/repo/compare/v1.1.0...v1.2.0
[1.1.0]: https://github.com/user/repo/compare/v1.0.0...v1.1.0
[1.0.0]: https://github.com/user/repo/releases/tag/v1.0.0

Best Practices

  1. Start with value: Lead with what the project does
  2. Quick start first: Get users running quickly
  3. Show, don't tell: Include code examples
  4. Keep updated: Sync with code changes
  5. Use badges: Show project health
  6. Add visuals: Screenshots and diagrams
  7. Link related: Connect to other docs
  8. Be consistent: Follow established patterns

Output Checklist

Every README should include:

  • Project title and description
  • Badges (build, version, license)
  • Features list
  • Quick start / Installation
  • Usage examples
  • API documentation
  • Configuration options
  • Contributing guidelines
  • License information
  • Support/contact info

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

accessibility-auditor

無料

Audits and implements web accessibility (a11y) following WCAG 2.1 guidelines with ARIA patterns, keyboard navigation, screen reader support, and contrast checking. Use when users request "accessibility audit", "a11y review", "WCAG compliance", "screen reader support", or "keyboard navigation".

日本語の概要は準備中です。原文の説明を表示しています。

sathishssj3/Stereix-Engine22026年10月4日 更新

adr-writer

無料

Creates Architecture Decision Records documenting key technical decisions with context, alternatives considered, tradeoffs, consequences, and decision owners. Use when documenting "architecture decisions", "technical choices", "design decisions", or "ADRs".

日本語の概要は準備中です。原文の説明を表示しています。

sathishssj3/Stereix-Engine22026年10月4日 更新

agent-orchestration-planner

無料

Designs multi-step agent workflows with tool usage, retry logic, state management, and budget controls. Provides orchestration diagrams, tool execution order, fallback strategies, and cost limits. Use for "AI agents", "agentic workflows", "multi-step AI", or "autonomous systems".

日本語の概要は準備中です。原文の説明を表示しています。

sathishssj3/Stereix-Engine22026年10月4日 更新

agent-reach

無料

MUST USE when user wants to 调研/research/搜索/search/查/找/look up anything on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X / 搜搜 X / 看看大家怎么评价 X / X 上有什么讨论 / research this topic。 Also MUST USE when user mentions any platform or shares any URL/链接: 小红书/xiaohongshu/xhs, Twitter/推特/X, B站/bilibili, Reddit, Facebook, Instagram, V2EX, LinkedIn/领英/招聘/求职/jobs, YouTube, GitHub code search, 小宇宙播客, 雪球/股票行情, RSS feeds, or any web URL. 15 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs). Zero config for 6 channels. Run `agent-reach doctor --json` to see which backend serves each platform right now. NOT for: 写报告/数据分析/翻译等内容加工（本 skill 只负责从互联网获取内容）； 发帖/评论/点赞等写操作；已有专门 skill 的平台（先用专门 skill）。 【路由方式】SKILL.md 包含路由表和常用命令，复杂场景需按需阅读对应分类的 references/*.md。 分类：search / social (小红书/推特/B站/V2EX/Reddit/Facebook/Instagram) / career(LinkedIn) / dev(github) / web(网页/文章/RSS) / video(YouTube/B站/播客) / finance(雪球/股票)。

日本語の概要は準備中です。原文の説明を表示しています。

sathishssj3/Stereix-Engine22026年10月4日 更新

ai-agent-orchestrator

無料

Orchestrates multi-agent AI systems with task delegation, agent communication, shared memory, and workflow coordination. Use when users request "multi-agent system", "agent orchestration", "AI agents", "agent coordination", or "autonomous agents".

日本語の概要は準備中です。原文の説明を表示しています。

sathishssj3/Stereix-Engine22026年10月4日 更新

alerting-dashboard-builder

無料

Creates SLO-based alerts and operational dashboards with key charts, alert thresholds, and runbook links. Use for "alerting", "dashboards", "SLO", or "monitoring".

日本語の概要は準備中です。原文の説明を表示しています。

sathishssj3/Stereix-Engine22026年10月4日 更新

sathishssj3 のスキルをすべて見る

このスキルの問題を報告する