skill-creator

name	skill-creator
description	Guide for creating effective skills for Apollo GraphQL and GraphQL development in this agentPlayground repo. Use this skill when: (1) creating a new skill (e.g., for GraphQL, AntD UI, portless, Turborepo tasks), (2) updating existing skills like the custom update-graphql or the Apollo ones, (3) learning best practices for SKILL.md in .grok/skills/ or portable in agents/skills/. Follow the structure used in this monorepo: rich frontmatter for Grok, references to specific files (apps/api/src/graphql/, staff/public, packages/, portless), coordination with other skills, and portable .md versions.
license	MIT
compatibility	Agent Skills format for Grok and other tools.
metadata	{"author":"apollographql (adapted)","version":"1.0.0"}
allowed-tools	Read Write Edit Glob Grep run_terminal_command search_replace

Skill Creator Guide (agentPlayground Monorepo)

This meta-skill helps create skills following the Agent Skills spec, tailored to this Turborepo with GraphQL (Apollo Server/Client), Ant Design UIs, portless, etc.

Directory Structure in This Repo

• .grok/skills//SKILL.md : Rich for Grok (frontmatter, allowed-tools, references to monorepo paths)
• agents/skills/.md : Portable markdown for Claude/Cursor/Copilot
• Use subdirs for references/ if complex.

See existing: .grok/skills/ has update-graphql, implement-feature, apollo-*, etc. agents/skills/ has matching .md

SKILL.md Format (Adapted)

Frontmatter:

---
name: my-skill
description: >
  Clear triggers: (1) ..., (2) ...
license: MIT
compatibility: ...
metadata:
  author: ...
  version: "1.0.0"
allowed-tools: Read Write ... run_terminal_command search_replace
---

Body: Overview, Process (with checkboxes), Quick Reference, Security (if sensitive), References (link to other skills/files in repo), Key Rules, Ground Rules (ALWAYS/NEVER tied to this monorepo's conventions like using tsgo, Biome, portless URLs, AntDProvider, shared packages).

Best Practices for This Repo

• Reference specific paths: apps/api/src/graphql/schema.ts, apps/staff/src/App.tsx, packages/ui/src/antd-provider.tsx, portless.json, turbo.json, etc.
• Tie to existing skills: "Use with update-graphql when changing API", "Coordinate with add-antd-component for UIs".
• For portable: Keep the .md version clean but reference the .grok one.
• Use the create-new-skill skill itself for meta.
• Follow Apollo Voice: approachable, opinionated, direct.
• Progressive disclosure: SKILL.md <500 lines, refs for details.
• Security: Add ## Security section if config/code affects data/auth (e.g., for MCP or schema).

Progressive Disclosure & Structure

• Frontmatter for discovery.
• Instructions in SKILL.md.
• references/ for deep dives (e.g., monorepo-specific patterns).
• Scripts/templates if needed (e.g., for validation with tsgo/biome).

Ground Rules

• ALWAYS make descriptions trigger-specific with (1) (2) lists.
• ALWAYS use checkboxes for steps.
• ALWAYS link references to this repo's files and other skills.
• NEVER exceed limits; use refs.
• COORDINATE new skills with the agent system (subagents, personas, .grok/config.toml).
• PREFER skills that help with the stack: GraphQL, AntD, Turborepo, portless, TS7/tsgo, Biome.

References

• Official skill-creator (apollo-skills.md for Apollo specifics).
• This repo: agents/STRUCTURE.md, agents/OVERVIEW.md, .grok/README.md, existing skills like create-new-skill, update-graphql, apollo-*.
• User guide for .grok/skills/ format.

Use this to expand the skills library in agentPlayground, keeping it useful for Grok and portable for other agents.