SkillsAdd

jburlison/metaprompts · Archived

agent-file-specs

Contains the complete specifications for AI coding assistant customization files including agents, skills, prompts, and instructions.

First seen Feb 19, 2026

Installation

$ npx skills add jburlison/metaprompts --skill agent-file-specs
View on skills.sh ↗ GitHub repository ↗

Summary

  • Contains the complete specifications for AI coding assistant customization files including agents, skills, prompts, and instructions.
  • Works with GitHub Copilot, Claude Code, Codex, OpenCode, and other providers.
  • Use this skill when you need to reference the correct file format, required fields, supported attributes, file locations, or VS Code settings for any customization file.
  • Follows the Agent Skills open standard (agentskills.io).

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

generate-agent-docs Same source
jburlison/metaprompts

Generates documentation and usage guides for agents, skills, prompts, and instructions. Works w…

5 installs
analyze-agent-overlap Same source
jburlison/metaprompts

Analyzes existing agents, skills, prompts, and instructions to identify overlaps, redundancies,…

5 installs
validate-agent-files Same source
jburlison/metaprompts

Validates AI coding assistant customization files (agents, skills, prompts, instructions) for c…

5 installs
agent-browser Similar · more installs
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

vercel-react-best-practices Shared topics
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Shared topics
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Shared topics
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-hosted-copilot-sdk Shared topics
microsoft/azure-skills 440.4K installs
azure-enterprise-infra-planner Shared topics
microsoft/azure-skills

Architect and provision enterprise Azure infrastructure from workload descriptions. For cloud a…

402.8K installs
supabase-postgres-best-practices Shared topics
supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill …

391.6K installs

Also in this package

Other skills from jburlison/metaprompts.

npx skills add jburlison/metaprompts
generate-agent-docs 5 analyze-agent-overlap 5 validate-agent-files 5

Browse all from jburlison/metaprompts

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Declared
GitHub Copilot Declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Declared

Repository health

Stars 76
Default branch main
Open issues 0
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code codex github-copilot opencode

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,959 B
  • docs SUMMARY.md 462 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 5 installs

SKILL.md

AI Coding Assistant Customization File Specifications

This skill provides the authoritative, up-to-date specifications for all AI coding assistant customization file types. Each file type has its own dedicated reference document with complete attribute tables, validation rules, examples, and best practices.

Standard: These specs align with the Agent Skills open standard
and the VS Code Copilot customization documentation.

How to Use This Skill

  1. Read the Quick Reference below to identify the file type you need.
  2. Follow the link to the dedicated reference document for full details.
  3. Use the [File Locations](references/FILE-LOCATIONS.md) reference when you

need to know where files go for a specific provider.

  1. Use the [Settings](references/SETTINGS.md) reference for VS Code

configuration.

Important: Detailed specifications live in the references/ folder —
not in this file. This keeps the main skill file lightweight for efficient
context loading per the
progressive disclosure model.

Quick Reference

Type Extension Purpose Reference
Agent .agent.md / .md Custom AI personas with specialized behaviors, tool restrictions, and handoff workflows [AGENTS.md](references/AGENTS.md)
Skill SKILL.md (directory-based) Reusable, portable capabilities with scripts and resources — follows the Agent Skills open standard [SKILLS.md](references/SKILLS.md)
Prompt .prompt.md Reusable prompt templates invoked as slash commands [PROMPTS.md](references/PROMPTS.md)
Instruction .instructions.md Contextual guidance applied automatically by file type or description [INSTRUCTIONS.md](references/INSTRUCTIONS.md)
File Locations — Provider folder mapping, directory structure, naming conventions [FILE-LOCATIONS.md](references/FILE-LOCATIONS.md)
VS Code Settings — Settings that control customization file discovery and behavior [SETTINGS.md](references/SETTINGS.md)

Provider Support

These specifications work across multiple AI coding assistant providers. Each provider uses its own base folder but the file formats are consistent:

Provider Base Folder
GitHub Copilot .github/
Claude Code .claude/
Codex .codex/
OpenCode .config/opencode/

See [FILE-LOCATIONS.md](references/FILE-LOCATIONS.md) for the complete directory structure and provider-specific details.

File Type Selection Guide

Use this decision tree to choose the right file type:

  • "I want coding standards applied everywhere" → Use always-on instructions

(.github/copilot-instructions.md or AGENTS.md). See [INSTRUCTIONS.md](references/INSTRUCTIONS.md).

  • "I want different rules for different file types" → Use file-based

instructions (.instructions.md with applyTo patterns). See [INSTRUCTIONS.md](references/INSTRUCTIONS.md).

  • "I have a reusable task I run repeatedly" → Use a prompt file

(.prompt.md) invoked as a slash command. See [PROMPTS.md](references/PROMPTS.md).

  • "I need a multi-step workflow with scripts and resources" → Use an Agent

Skill (directory with SKILL.md). Portable across tools. See [SKILLS.md](references/SKILLS.md).

  • "I need a specialized AI persona with tool restrictions" → Use a custom

agent (.agent.md). Supports handoffs for multi-step workflows. See [AGENTS.md](references/AGENTS.md).

Authoritative Sources