skills.rest
wenyue
wenyueCOMMUNITY
Explore all skills by this author →
GitHub

setup-project-agents

Generates and synchronizes project Rules, Skills, Agents, and MCP configurations across Codex, Cursor, Copilot, and Qoder.

Updated May 19, 2026
Search Tags:#workflow automation#codex#mcp#agent configuration#cursor#copilot#rules sync
One-click install
npx skills add https://github.com/wenyue/SmartKit --skill setup-project-agents-wenyue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-project-agents
Source: https://github.com/wenyue/SmartKit/tree/main/docs/zh-CN/skills/setup-project-agents
Command: npx skills add https://github.com/wenyue/SmartKit --skill setup-project-agents-wenyue

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Keeping AI coding assistant configurations consistent across Codex, Cursor, GitHub Copilot, and Qoder requires manually rewriting Rules, Skills, Agents, and MCP declarations for each host. This Skill automates full setup and incremental synchronization of these project-level agent configurations from a single catalog. ## Core Features & Use Cases - Full Setup Sessions: Runs a frozen, transactional session that regenerates all catalog-declared project Rules and Skills from immutable Setup Authoring Contracts, with rollback and recovery on failure. - Project Sync: Performs local, session-free synchronization of Rule indexes and declared Agent/MCP mappings after project source files or .agents/config.json change, with check-only drift detection. - Ownership Protection: Records generated outputs in .agents/smartkit.lock.json, preserves project-owned files byte-for-byte outside managed sections, and refuses to overwrite conflicting content. - Use Case: After adding a new MCP server declaration to your project config, run the sync operation to update the AGENTS.md rule index and host mappings atomically, then verify convergence with the clean check mode. ## Quick Start Ask the agent to set up or update this repository's Rules, Skills, Agents, and MCP configuration for Codex, Cursor, Copilot, and Qoder.

Frequently Asked Questions about setup-project-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up AI agent rules for Codex, Cursor, Copilot, and Qoder in one repo?▼

Run the full setup workflow, which starts a frozen session, regenerates all catalog-declared project Rules and Skills from immutable contracts, and applies them transactionally. The catalog enables all four hosts by default.

How do I sync AGENTS.md after editing project config?▼

Use the sync-project-rules local operation after editing supported project source files or .agents/config.json. Run it with --check first to preview drift, then without the flag to apply changes atomically while preserving all content outside the managed Project rules section.

Does the setup overwrite my existing project rules and files?▼

No. Project-owned Rules, Skills, and agent source files are preserved, and only files recorded in .agents/smartkit.lock.json plus one AGENTS.md section are managed. Ownership conflicts or duplicate sections stop the process before any replacement.

When is a full setup required instead of a local sync?▼

Full setup is required when ownership records are missing or outdated, or when external Skill declarations change. Local sync only updates recorded project mappings and never fetches external content or regenerates contract artifacts.

What happens if the setup session fails midway?▼

The transaction attempts to restore the pre-finish state and refuses rollback modifications if third-party concurrent changes are detected. Failure reports include residual session paths and recovery evidence so you can resolve the cause and start a new session.

Related Skills

Explore More Software Engineering Skills→
githubgithub
5.1k

http-mcp-headers

Implement secret-safe HTTP headers for MCP transport in gh-aw workflows.

Official
Intermediate
jamescjamesc

sync-skills

Synchronize modified skills and agents to a repository and create a pull request.

Community
Intermediate
endorlabsendorlabs
10

endor-agent-kit-setup

Automate Endor Labs Agent Kit prerequisite setup and verification for Gemini CLI.

Official
Intermediate
tomtoto757tomtoto757
3

magento-multi-store

Configure Magento multi-website hierarchies with scoped configuration, nginx routing, and shared catalogs.

Community
Advanced