diff --git a/CLAUDE.md b/CLAUDE.md index 50f7c16..bb7b156 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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/-skills//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/-skills//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 中注册 diff --git a/EVALUATION_REPORT.md b/EVALUATION_REPORT.md new file mode 100644 index 0000000..de2c837 --- /dev/null +++ b/EVALUATION_REPORT.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 diff --git a/README.en.md b/README.en.md index 1862008..c4f6c69 100644 --- a/README.en.md +++ b/README.en.md @@ -10,7 +10,7 @@ [![License](https://img.shields.io/badge/License-Apache%202.0-green)](LICENSE) [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Compatible-purple)](https://agentskills.io) -English | [简体中文](./README.zh-CN.md) +[简体中文](./README.md) [Introduction](#-introduction) · [Install](#-install) · diff --git a/README.md b/README.md index cc63c68..0c413cf 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ [![License](https://img.shields.io/badge/License-Apache%202.0-green)](LICENSE) [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Compatible-purple)](https://agentskills.io) -[English](./README.md) | 简体中文 +[English](./README.en.md) [简介](#-简介) · [安装](#-安装) · diff --git a/SKILLS_INDEX.md b/SKILLS_INDEX.md new file mode 100644 index 0000000..d4ed47d --- /dev/null +++ b/SKILLS_INDEX.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) +