mirror of
https://github.com/partme-ai/full-stack-skills.git
synced 2026-09-14 18:20:58 +08:00
chore: update CLAUDE.md to reflect navigation hub structure
This commit is contained in:
wandl-6A72h
@@ -1,115 +1,36 @@
|
||||
# CLAUDE.md
|
||||
|
||||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||||
Full Stack Skills 导航中心 — 面向 AI Coding Agent 的全栈技能生态。
|
||||
|
||||
## Project Overview
|
||||
## 定位
|
||||
|
||||
Full-Stack-Skills is an open-source Agent Skills marketplace repository — a collection of 421+ skills across 42 groups covering frontend, backend, DevOps, design, documentation, and spec-driven development. Skills are packaged as `SKILL.md` files that Claude Code (and other Agent Skills-compatible platforms) loads on demand to extend its capabilities for specific tasks.
|
||||
本仓库是 **全栈技能生态的导航站和目录**，不是技能代码仓库。
|
||||
|
||||
The repository serves dual roles:
|
||||
- **Authoring environment**: Where skills are created, edited, and maintained following the [Agent Skills specification](https://agentskills.io/)
|
||||
- **Marketplace source**: Published via `.claude-plugin/marketplace.json` for installation through Claude Code's `/plugin` system
|
||||
技能代码分布在 [full-statck-skills](https://github.com/full-statck-skills) GitHub 组织下的独立仓库中，本仓库提供统一入口、安装指南和社区资源索引。
|
||||
|
||||
Language convention (inherited from parent workspace): **Chinese** for documentation, comments, and commit messages.
|
||||
|
||||
## Skill Directory Structure
|
||||
|
||||
Skills follow a strict two-level grouping:
|
||||
## 仓库结构
|
||||
|
||||
```
|
||||
skills/<group>-skills/<skill-name>/SKILL.md
|
||||
README.md # 中文导航页（默认）
|
||||
README.en.md # 英文导航页
|
||||
CLAUDE.md # 本文件
|
||||
AGENTS.md # AI Agent 工作指南
|
||||
AWESOME_AGENT_SKILLS.md # 全技能索引
|
||||
LICENSE # Apache 2.0
|
||||
docs/ # 文档
|
||||
media/ # 媒体资源
|
||||
spec/ # 规范
|
||||
```
|
||||
|
||||
Each skill directory may optionally contain:
|
||||
- `examples/` — usage examples
|
||||
- `references/` — longer reference material (keeps SKILL.md under 500 lines)
|
||||
- `scripts/` — executable automation scripts
|
||||
- `assets/` — images, templates, and other resources
|
||||
- `templates/` — code templates
|
||||
**不要在此仓库中添加 skills/ 目录或 marketplace.json。** 新技能应创建为 [full-statck-skills](https://github.com/full-statck-skills) 组织下的独立仓库。
|
||||
|
||||
### Naming Conventions
|
||||
## 技能包（42+ 个独立仓库）
|
||||
|
||||
- **Skill directory**: `kebab-case` (e.g., `vue3`, `spring-boot`, `tauri-app-creator`)
|
||||
- **SKILL.md**: Always uppercase, exact filename `SKILL.md`
|
||||
- **Scripts**: `kebab-case.sh` with `#!/bin/bash` shebang, `set -e`, status to stderr, machine-readable output to stdout
|
||||
- **Zip files**: Must match directory name exactly (`{skill-name}.zip`)
|
||||
详见 [README.md](README.md) 中的技能目录表，涵盖前端、后端、移动端、DevOps、设计、文档等 15 个领域，共 460+ 个技能。
|
||||
|
||||
## SKILL.md Format
|
||||
## 修改规则
|
||||
|
||||
Every skill file requires YAML frontmatter with `name` and `description`:
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: {skill-name}
|
||||
description: {One sentence describing trigger conditions. Be specific so Claude can determine when to activate.}
|
||||
---
|
||||
|
||||
# {Skill Title}
|
||||
|
||||
{Brief description of what the skill does and when to use it.}
|
||||
```
|
||||
|
||||
Key frontmatter rules:
|
||||
- `name` must match the directory name
|
||||
- `description` is the primary trigger mechanism — Claude uses it to decide whether to load the skill. Write it to describe *when* to use the skill, not just what it is
|
||||
- Keep SKILL.md under 500 lines; move reference material to `references/`
|
||||
|
||||
## Marketplace Configuration
|
||||
|
||||
The file `.claude-plugin/marketplace.json` defines which skills are published. Each plugin maps to a skill group:
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "full-stack-skills",
|
||||
"plugins": [
|
||||
{
|
||||
"name": "vue-skills",
|
||||
"description": "...",
|
||||
"source": "./",
|
||||
"strict": false,
|
||||
"skills": [
|
||||
"./skills/vue-skills/vue2",
|
||||
"./skills/vue-skills/vue3"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**Important distinction**: `skills/` directory is the source of truth for what exists in the repo; `marketplace.json` is the source of truth for what is published. Currently 2 groups exist in-repo but are not published: `threejs-skills` (18 skills) and `vscode-skills` (4 skills). When adding new skills, update both the directory and marketplace.json together.
|
||||
|
||||
The `docs/repository-map.md` tracks all known discrepancies between the directory and marketplace.
|
||||
|
||||
## Key Documentation Files
|
||||
|
||||
- `README.md` — Full project README (Chinese, with marketplace tables, installation guides, scenario-based install paths)
|
||||
- `README.zh-CN.md` — Detailed Chinese README with full skill catalog and architecture overview
|
||||
- `AGENTS.md` — Guidance for AI agents working in this repo (skill creation rules, directory conventions, zip packaging)
|
||||
- `AGENTS_EN.md` — English version of AGENTS.md
|
||||
- `AGENTS_PROMPT.md` — Role definitions and agent prompts for 50+ roles (product manager, architect, developer, etc.)
|
||||
- `ROLE_DEFINITIONS.md` — Structured role definitions with responsibilities, tools, and skill assignments
|
||||
- `PLATFORM_GUIDE.md` — Complete platform matrix with install paths for all 43 platforms
|
||||
- `QUICKSTART.md` — 5-minute marketplace setup guide for users forking this repo
|
||||
- `PLANNING_SKILL_CATEGORIES.md` — Skill category planning and classification
|
||||
- `SKILLS_INDEX.md` — Complete index of all in-repo skills organized by category
|
||||
- `docs/repository-map.md` — Canonical snapshot of repo structure vs. marketplace state
|
||||
- `docs/skill-group-mapping.md` — Mapping of skills to groups
|
||||
- `docs/pipeline-stage-to-skills.md` — Pipeline stage (requirements → design → dev → test → deploy) to skills mapping
|
||||
- `docs/skills-ecosystem.md` — Overview of the broader skills ecosystem across related repos
|
||||
|
||||
## Adding a New Skill
|
||||
|
||||
1. Create `skills/<group>-skills/<skill-name>/SKILL.md` with proper frontmatter
|
||||
2. Add optional subdirectories (`references/`, `scripts/`, `examples/`, `assets/`)
|
||||
3. If the group plugin already exists in `marketplace.json`, append the skill path to its `skills` array
|
||||
4. If it's a new group, add both the plugin entry in `marketplace.json` and update `docs/repository-map.md`
|
||||
5. Update `SKILLS_INDEX.md` with the new skill entry
|
||||
6. Update README snapshot numbers if counts changed
|
||||
|
||||
## Important Constraints
|
||||
|
||||
- `skills/pencil-skills/docs/` is treated as supporting documentation, not a skill directory — excluded from conversion
|
||||
- The `.gitignore` excludes `.DS_Store`, `__pycache__/`, `.idea/`, `.vscode/`
|
||||
- License: Apache 2.0 (repo-level), but `skills/document-skills/{docx,pptx,pdf,xlsx}` are source-available, not open source
|
||||
- Skills use progressive disclosure: SKILL.md should be concise, reference material goes in separate files
|
||||
- Script paths in SKILL.md should use the absolute mount path format: `/mnt/skills/user/{skill-name}/scripts/{script}.sh`
|
||||
- README.md / README.en.md 是主要维护的文档
|
||||
- 更新技能目录时同步更新两个语言版本的表格
|
||||
- 不引入 skills/ 目录或 marketplace.json
|
||||
- 新技能仓库创建后在 README 和 AWESOME_AGENT_SKILLS.md 中注册
|
||||
|
||||
@@ -0,0 +1,61 @@
|
||||
# TRACE Evaluation Report
|
||||
|
||||
## Summary
|
||||
|
||||
- **Total Skills Evaluated**: 57
|
||||
- **Average Score**: 4.27/5.0
|
||||
- **Skills with Score ≥ 4.5**: 2
|
||||
- **Skills with Score < 4.5**: 55
|
||||
|
||||
## Top 10 Skills
|
||||
|
||||
| Rank | Skill | Score |
|
||||
|------|-------|-------|
|
||||
| 1 | python-type-safety | 4.51 |
|
||||
| 2 | kpi-dashboard-design | 4.50 |
|
||||
| 3 | api-design-principles | 4.45 |
|
||||
| 4 | python-background-jobs | 4.42 |
|
||||
| 5 | python-configuration | 4.42 |
|
||||
| 6 | python-resource-management | 4.41 |
|
||||
| 7 | python-observability | 4.41 |
|
||||
| 8 | cost-optimization | 4.41 |
|
||||
| 9 | terraform-module-library | 4.41 |
|
||||
| 10 | mtls-configuration | 4.41 |
|
||||
|
||||
## Bottom 10 Skills (Need Optimization)
|
||||
|
||||
| Rank | Skill | Score |
|
||||
|------|-------|-------|
|
||||
| 1 | istio-traffic-management | 4.28 |
|
||||
| 2 | python-anti-patterns | 4.27 |
|
||||
| 3 | github-actions-templates | 4.26 |
|
||||
| 4 | brand-landingpage | 4.26 |
|
||||
| 5 | temporal-python-testing | 4.26 |
|
||||
| 6 | deployment-pipeline-design | 4.24 |
|
||||
| 7 | airflow-dag-patterns | 4.23 |
|
||||
| 8 | python-testing-patterns | 4.21 |
|
||||
| 9 | gitlab-ci-patterns | 4.18 |
|
||||
|
||||
## Evaluation Details
|
||||
|
||||
Each skill was evaluated across 5 dimensions:
|
||||
|
||||
1. **T (Trust)**: Security, privacy, and trustworthiness
|
||||
2. **R (Reliability)**: Error handling, stability, and robustness
|
||||
3. **A (Adaptability)**: Flexibility and customization
|
||||
4. **C (Convention)**: Documentation, examples, and best practices
|
||||
5. **E (Effectiveness)**: Performance, efficiency, and results
|
||||
|
||||
Scores range from 1.0 to 5.0, with 4.5+ considered excellent.
|
||||
|
||||
## Optimization Status
|
||||
|
||||
Skills with scores below 4.5 are being optimized through:
|
||||
|
||||
1. Adding Chinese content for better localization
|
||||
2. Improving boundary definitions
|
||||
3. Adding workflow steps and examples
|
||||
4. Enhancing documentation and gotchas
|
||||
5. Fixing frontmatter and structure
|
||||
|
||||
Last updated: 2026-06-06
|
||||
+1
-1
@@ -10,7 +10,7 @@
|
||||
[](LICENSE)
|
||||
[](https://agentskills.io)
|
||||
|
||||
English | [简体中文](./README.zh-CN.md)
|
||||
[简体中文](./README.md)
|
||||
|
||||
[Introduction](#-introduction) ·
|
||||
[Install](#-install) ·
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
[](LICENSE)
|
||||
[](https://agentskills.io)
|
||||
|
||||
[English](./README.md) | 简体中文
|
||||
[English](./README.en.md)
|
||||
|
||||
[简介](#-简介) ·
|
||||
[安装](#-安装) ·
|
||||
|
||||
@@ -0,0 +1,81 @@
|
||||
# Skills Index
|
||||
|
||||
This document lists all available skills in the repository.
|
||||
|
||||
## Backend Development
|
||||
|
||||
- [api-design-principles](skills/api-design-principles/SKILL.md)
|
||||
- [async-python-patterns](skills/async-python-patterns/SKILL.md)
|
||||
- [fastapi-templates](skills/fastapi-templates/SKILL.md)
|
||||
- [microservices-patterns](skills/microservices-patterns/SKILL.md)
|
||||
- [python-anti-patterns](skills/python-anti-patterns/SKILL.md)
|
||||
- [python-background-jobs](skills/python-background-jobs/SKILL.md)
|
||||
- [python-code-style](skills/python-code-style/SKILL.md)
|
||||
- [python-configuration](skills/python-configuration/SKILL.md)
|
||||
- [python-design-patterns](skills/python-design-patterns/SKILL.md)
|
||||
- [python-error-handling](skills/python-error-handling/SKILL.md)
|
||||
- [python-observability](skills/python-observability/SKILL.md)
|
||||
- [python-packaging](skills/python-packaging/SKILL.md)
|
||||
- [python-performance-optimization](skills/python-performance-optimization/SKILL.md)
|
||||
- [python-project-structure](skills/python-project-structure/SKILL.md)
|
||||
- [python-resilience](skills/python-resilience/SKILL.md)
|
||||
- [python-resource-management](skills/python-resource-management/SKILL.md)
|
||||
- [python-testing-patterns](skills/python-testing-patterns/SKILL.md)
|
||||
- [python-type-safety](skills/python-type-safety/SKILL.md)
|
||||
- [temporal-python-testing](skills/temporal-python-testing/SKILL.md)
|
||||
|
||||
## Frontend Development
|
||||
|
||||
- [nextjs-app-router-patterns](skills/nextjs-app-router-patterns/SKILL.md)
|
||||
- [react-native-architecture](skills/react-native-architecture/SKILL.md)
|
||||
- [react-state-management](skills/react-state-management/SKILL.md)
|
||||
- [security-requirement-extraction](skills/security-requirement-extraction/SKILL.md)
|
||||
- [tailwind-design-system](skills/tailwind-design-system/SKILL.md)
|
||||
|
||||
## DevOps & Infrastructure
|
||||
|
||||
- [deployment-pipeline-design](skills/deployment-pipeline-design/SKILL.md)
|
||||
- [gitlab-ci-patterns](skills/gitlab-ci-patterns/SKILL.md)
|
||||
- [hybrid-cloud-networking](skills/hybrid-cloud-networking/SKILL.md)
|
||||
- [multi-cloud-architecture](skills/multi-cloud-architecture/SKILL.md)
|
||||
- [terraform-module-library](skills/terraform-module-library/SKILL.md)
|
||||
|
||||
## Data Engineering
|
||||
|
||||
- [airflow-dag-patterns](skills/airflow-dag-patterns/SKILL.md)
|
||||
- [data-quality-frameworks](skills/data-quality-frameworks/SKILL.md)
|
||||
- [data-storytelling](skills/data-storytelling/SKILL.md)
|
||||
- [dbt-transformation-patterns](skills/dbt-transformation-patterns/SKILL.md)
|
||||
- [spark-optimization](skills/spark-optimization/SKILL.md)
|
||||
|
||||
## Security
|
||||
|
||||
- [attack-tree-construction](skills/attack-tree-construction/SKILL.md)
|
||||
- [sast-configuration](skills/sast-configuration/SKILL.md)
|
||||
- [threat-mitigation-mapping](skills/threat-mitigation-mapping/SKILL.md)
|
||||
|
||||
## Architecture
|
||||
|
||||
- [architecture-patterns](skills/architecture-patterns/SKILL.md)
|
||||
- [event-store-design](skills/event-store-design/SKILL.md)
|
||||
- [kpi-dashboard-design](skills/kpi-dashboard-design/SKILL.md)
|
||||
- [linkerd-patterns](skills/linkerd-patterns/SKILL.md)
|
||||
- [projection-patterns](skills/projection-patterns/SKILL.md)
|
||||
- [stride-analysis-patterns](skills/stride-analysis-patterns/SKILL.md)
|
||||
- [wcag-audit-patterns](skills/wcag-audit-patterns/SKILL.md)
|
||||
- [workflow-orchestration-patterns](skills/workflow-orchestration-patterns/SKILL.md)
|
||||
|
||||
## Other
|
||||
|
||||
- [brand-landingpage](skills/brand-landingpage/SKILL.md)
|
||||
- [cost-optimization](skills/cost-optimization/SKILL.md)
|
||||
- [cqrs-implementation](skills/cqrs-implementation/SKILL.md)
|
||||
- [github-actions-templates](skills/github-actions-templates/SKILL.md)
|
||||
- [istio-traffic-management](skills/istio-traffic-management/SKILL.md)
|
||||
- [mtls-configuration](skills/mtls-configuration/SKILL.md)
|
||||
- [saga-orchestration](skills/saga-orchestration/SKILL.md)
|
||||
- [screen-reader-testing](skills/screen-reader-testing/SKILL.md)
|
||||
- [secrets-management](skills/secrets-management/SKILL.md)
|
||||
- [service-mesh-observability](skills/service-mesh-observability/SKILL.md)
|
||||
- [uv-package-manager](skills/uv-package-manager/SKILL.md)
|
||||
|
||||
Reference in New Issue
Block a user