Convert copilot instructions to modular agent skills with symlink structure

[Copilot]

Why

• Single source of truth for agent instructions across multiple AI assistants (Claude, Gemini, Codex)
• Modular organization enables focused skill discovery and maintenance
• Eliminates duplication when supporting multiple assistant platforms

How

• Decomposed .github/copilot-instructions.md into 6 focused skill files:
  • bootstrap-setup.md - Environment setup, installation, network limitations
  • build-test.md - Linting, formatting, validation workflows
  • code-structure.md - Repository layout, entry points, config files
  • cli-operations.md - CLI commands, authentication, examples
  • development-tasks.md - Code change workflows, model/pipeline development
  • troubleshooting.md - Common errors and solutions
• Created AGENTS.md as entry point with skill directory overview
• Established symlink structure:
  • .claude/skills → .github/skills
  • .gemini/skills → .github/skills
  • .codex/skills → .github/skills
  • CLAUDE.md → AGENTS.md

Tests

• Verified symlinks resolve correctly across all agent directories
• Confirmed file access through symlink paths

Notes

• Original .github/copilot-instructions.md preserved for reference
• Future maintenance requires updating only .github/skills/ and AGENTS.md

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Convert copilot instructions into agent skills</issue_title>
<issue_description>We want to convert our previous copilot instructions in to agent skills spec. Previous is here https://github.com/Clarifai/clarifai-python/blob/master/.github/copilot-instructions.md

The skills should be in .github/skills directory.
Instructions outside of the skills should be in a top level AGENTS.md file.

Then I'd like you to add symlinks from .claude/skills, .gemini/skills and .codex/skills to .github/skills.
Additionally add a symlink of CLAUDE.md to AGENTS.md

That way going forward we can maintain the .github/skills and AGENTS.md files only.</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Convert copilot instructions into agent skills #934

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Copilot]

Pull request overview

This PR converts the monolithic .github/copilot-instructions.md into a modular agent skills structure that can be shared across multiple AI assistants (Claude, Gemini, Codex). The new structure provides a single source of truth for agent instructions through focused skill files and a symlink-based distribution system.

Changes:

• Created 6 specialized skill files in .github/skills/ covering setup, testing, code structure, CLI operations, development workflows, and troubleshooting
• Added AGENTS.md as the main entry point with skill directory overview
• Established symlink structure allowing .claude/, .gemini/, and .codex/ directories to reference the centralized .github/skills/ directory

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
AGENTS.md	Main entry point providing overview of available skills and general development guidelines
CLAUDE.md	Symlink to AGENTS.md for Claude-specific access
.github/skills/bootstrap-setup.md	Environment setup instructions including network-limited alternatives
.github/skills/build-test.md	Build, lint, format, and test procedures
.github/skills/code-structure.md	Repository layout and key entry points
.github/skills/cli-operations.md	CLI command reference and authentication setup
.github/skills/development-tasks.md	Common development workflows and model/pipeline development
.github/skills/troubleshooting.md	Solutions to common installation and development issues
.github/skills/README.md	Skills directory overview and usage documentation
.claude/skills	Symlink to .github/skills
.gemini/skills	Symlink to .github/skills
.codex/skills	Symlink to .github/skills

Comments suppressed due to low confidence (4)

CLAUDE.md:1

• This file appears to contain only a filename reference rather than being an actual symlink. On Unix-like systems, symlinks show their target path but are created using ln -s. Verify this is created as a proper symlink using ln -s AGENTS.md CLAUDE.md rather than a text file containing the target name.

# Clarifai Python SDK

.claude/skills:1

• The symlink target uses a relative path ../.github/skills. Verify this resolves correctly from the .claude/ directory. The target should point to ../.github/skills which would be correct if .claude/ is at the repository root. However, confirm the actual directory structure matches this assumption.
  .gemini/skills:1
• Similar to .claude/skills, verify this symlink resolves correctly. The relative path ../.github/skills assumes .gemini/ is at the repository root level.
  .codex/skills:1
• Similar to other symlinks, verify this resolves correctly. The relative path ../.github/skills assumes .codex/ is at the repository root level.

[github-actions]

Package	Line Rate	Health
clarifai	45%	❌
clarifai.cli	68%	➖
clarifai.cli.templates	46%	❌
clarifai.client	65%	➖
clarifai.client.auth	67%	➖
clarifai.constants	100%	✔
clarifai.datasets	100%	✔
clarifai.datasets.export	80%	✔
clarifai.datasets.upload	75%	➖
clarifai.datasets.upload.loaders	37%	❌
clarifai.models	100%	✔
clarifai.rag	0%	❌
clarifai.runners	53%	➖
clarifai.runners.models	64%	➖
clarifai.runners.pipeline_steps	39%	❌
clarifai.runners.pipelines	71%	➖
clarifai.runners.utils	62%	➖
clarifai.runners.utils.data_types	72%	➖
clarifai.schema	100%	✔
clarifai.urls	58%	➖
clarifai.utils	60%	➖
clarifai.utils.evaluation	16%	❌
clarifai.workflows	95%	✔
Summary	62% (10029 / 16301)	➖

Minimum allowed line rate is 50%