dym-scientific-agent-skills-dong-gop-them-sua-skill

Skill: dym-scientific-agent-skills-dong-gop-them-sua-skill — Đóng góp: thêm hoặc sửa một skill

Track ĐÓNG GÓP. File này dành cho người clone chính repo skill để sửa nó. Nếu bạn chỉ muốn dùng skill, quay lại 01.

Vì sao dùng: repo có một số luật ngầm mà CI chặn cứng và validator báo lỗi rất khó hiểu (đặc biệt là luật strictyaml). File này là bản kê đúng thứ tự, để PR không bị đá vì lý do hình thức. Sinh ra cái gì: một skills/<name>/ hợp lệ, một tests/<name>/ nếu skill có scripts/, một entry trong tests/skill-requirements.toml, và một PR vượt cổng.

---

0. Có nên nằm trong repo này không

AGENTS.md liệt kê các loại bị từ chối như thường lệ:

• Skill kỹ thuật phần mềm/phán đoán code chung — chúng cạnh tranh chỗ chọn ở mọi task.
• Hạ tầng chung có dán thêm một ví dụ khoa học (vector database, cloud SDK) — nhận một cái là phải gánh mọi đối thủ.
• Skill "orchestrator" rộng, chuyên route sang skill khác — theo thiết kế là đè lên mọi chuyên gia.
• Provider thứ hai cho một dịch vụ đã có skill.

Trong phạm vi: một skill hẹp cho một package/database/platform/workflow nghiên cứu — scanpy, depmap, benchling-integration, experimental-design.

Các skill dùng chung đang tồn tại (docx, pdf, pptx, generate-image, markdown-mermaid-writing) là helper định dạng output hẹp, và AGENTS.md nói thẳng chúng không phải tiền lệ để mở rộng phạm vi.

1. Layout

plugin.json                 # manifest Agent Plugins (repo root)
skills/<skill-name>/
├── SKILL.md        # BẮT BUỘC — file duy nhất bắt buộc
├── references/     # tuỳ chọn: tài liệu dài, chỉ nạp khi cần
├── scripts/        # tuỳ chọn: helper chạy được
└── assets/         # tuỳ chọn: template, tài nguyên tĩnh

Ba luật tuyệt đối:

• Tên thư mục = name trong frontmatter. Không khớp là hỏng.
• Test KHÔNG BAO GIỜ nằm dưới skills/. Thư mục skill chỉ chứa thứ agent nạp. Test đi vào tests/<skill-name>/, fixture vào tests/<skill-name>/fixtures/.
• Diagram cũng không nằm dưới skills/. Nếu có, nó ở docs/images/<skill-name>.png.