Skip to content

Agent Skill for AI coding assistants (Cursor, Copilot, Windsurf, Claude) - Adobe Express add-on development with OAuth patterns and code samples

License

Notifications You must be signed in to change notification settings

Sandgrouse/adobe-express-dev-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Adobe Express Development Skill for AI Coding Assistants

Expert guidance for Adobe Express add-on development with MCP server integration, OAuth patterns, and comprehensive code samples catalog.

License: MIT Agent Skills Adobe Express

What is This?

An Agent Skill for AI coding assistants that provides expert knowledge and tooling for developing Adobe Express add-ons. Works with Cursor, GitHub Copilot, Windsurf, Claude Code, Continue.dev, Google Antigravity, and any MCP-compatible IDE.

When you're working on Adobe Express projects, this skill automatically activates to help you with:

  • πŸ“š Accessing latest Adobe Express API documentation via MCP server
  • πŸ” Implementing OAuth 2.0 authentication (PKCE flow)
  • 🎨 Building UIs with Spectrum Web Components
  • πŸ“¦ Understanding project structure and architecture
  • πŸ’Ύ Data persistence and storage patterns
  • πŸ–ΌοΈ Document manipulation (shapes, text, images, audio, video)
  • πŸ”„ Communication between iframe runtime and document sandbox
  • πŸ› οΈ Troubleshooting common issues

Features

βœ… MCP Server Integration - Uses Adobe Express MCP server for up-to-date documentation
βœ… OAuth 2.0 Guide - Complete PKCE implementation with 4 cloud providers
βœ… 13 Code Samples Catalog - Official Adobe samples with detailed descriptions
βœ… OAuthUtils.js Reference - Reusable OAuth helper module
βœ… 8 Step-by-Step Workflows - Common development tasks
βœ… Production Patterns - Real-world implementation examples
βœ… Best Practices - Security, performance, and UX guidelines

Installation

1. Clone this repository to your skills directory

For Cursor / Windsurf / Continue.dev:

cd ~/.continue/skills/  # or ~/.windsurf/skills/ or ~/.cursor/skills/
git clone https://github.com/YOUR_USERNAME/adobe-express-dev-skill.git adobe-express-dev

For GitHub Copilot (VS Code):

cd ~/.copilot/skills/
git clone https://github.com/YOUR_USERNAME/adobe-express-dev-skill.git adobe-express-dev

For Claude Desktop:

cd ~/Library/Application\ Support/Claude/skills/  # macOS
git clone https://github.com/YOUR_USERNAME/adobe-express-dev-skill.git adobe-express-dev

For Google Antigravity:

cd ~/.gemini/antigravity/global_skills/  # Global (all workspaces)
git clone https://github.com/YOUR_USERNAME/adobe-express-dev-skill.git adobe-express-dev

# OR for workspace-specific:
cd <your-workspace>/.agent/skills/
git clone https://github.com/YOUR_USERNAME/adobe-express-dev-skill.git adobe-express-dev

2. Configure Adobe Express MCP Server

For VS Code / Cursor / Windsurf:
Add to .vscode/mcp.json or your IDE's MCP settings:

{
  "mcpServers": {
    "adobe-express": {
      "command": "npx",
      "args": [
        "-y",
        "@adobe/express-developer-mcp@latest"
      ]
    }
  }
}

For Claude Desktop:
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "adobe-express": {
      "command": "npx",
      "args": ["-y", "@adobe/express-developer-mcp@latest"]
    }
  }
}

3. Restart your AI coding assistant

The skill will automatically activate when you work on Adobe Express add-on projects.

What's Included

Main Skill (SKILL.md)

  • When to Use: Trigger keywords and scenarios
  • Key Concepts: Two-runtime architecture, import patterns, SDK usage
  • 8 Workflows: API docs access, project structure, document content, UI building, OAuth, communication, samples, debugging
  • Best Practices: Security, performance, testing
  • Troubleshooting: Common issues and solutions

OAuth Implementation Guide (references/oauth-implementation.md)

  • PKCE flow step-by-step with code examples
  • OAuthUtils.js helper module documentation
  • Provider configurations: Dropbox, OneDrive, Google Drive, Box
  • Token storage with Client Storage API
  • Login/logout UI patterns
  • Error handling examples
  • Production-ready code snippets

Code Samples Catalog (references/code-samples.md)

Comprehensive guide to 13 official Adobe Express samples:

  • import-images-using-oauth ⭐ - Complete OAuth + cloud storage
  • use-client-storage - Data persistence patterns
  • export-sample - Export renditions (JPEG, PNG, PDF, MP4)
  • audio-recording-addon - Media handling
  • pix - Advanced canvas-based editor
  • Plus 8 more covering React, Vue, Spectrum, and more

Quick Start Examples

Access Latest API Documentation

Ask: "How do I create text in Adobe Express?"
β†’ Skill uses MCP server to fetch current documentation

Implement OAuth for Dropbox

Ask: "How do I implement OAuth for Dropbox?"
β†’ Skill references oauth-implementation.md
β†’ Provides PKCE flow code + OAuthUtils.js link

Find Code Samples

Ask: "Show me Adobe Express samples for drag and drop"
β†’ Skill references code-samples.md
β†’ Returns relevant samples with GitHub links

File Structure

adobe-express-dev/
β”œβ”€β”€ SKILL.md                              # Main skill instructions
β”œβ”€β”€ README.md                             # This file
β”œβ”€β”€ LICENSE                               # MIT License
└── references/
    β”œβ”€β”€ oauth-implementation.md           # OAuth 2.0 complete guide
    └── code-samples.md                   # 13 official samples catalog

When This Skill Activates

Your AI assistant automatically uses this skill when you:

  • Mention "Adobe Express", "add-on", "express-document-sdk"
  • Work with document sandbox or iframe runtime
  • Implement OAuth authentication
  • Use Spectrum Web Components
  • Ask about Adobe Express APIs or development patterns

Compatible with: Cursor, GitHub Copilot, Windsurf, Claude Code, Continue.dev, Google Antigravity, and any MCP-compatible IDE.

Prerequisites

  • AI Coding Assistant - One of:
    • Cursor (recommended - free)
    • GitHub Copilot (VS Code, JetBrains)
    • Windsurf (Codeium)
    • Claude Code (Anthropic)
    • Continue.dev (open source)
    • Google Antigravity (Google)
    • Any MCP-compatible IDE
  • Adobe Express MCP Server configured in your IDE
  • Node.js 18+ for local add-on development
  • Adobe Express account for testing add-ons

How It Works

  1. You ask a question about Adobe Express development
  2. Skill detects relevant keywords (add-on, OAuth, document sandbox, etc.)
  3. Skill activates and provides:
    • References to bundled guides (OAuth, samples)
    • MCP server queries for latest API docs
    • Code examples and patterns
    • Links to official resources
  4. You get accurate, actionable guidance without leaving your IDE

Works seamlessly with: Cursor, GitHub Copilot, Windsurf, Claude Code, Continue.dev, Google Antigravity, and all MCP-compatible AI coding assistants.

What This Skill Does NOT Do

❌ Does not duplicate entire code samples (provides links instead)
❌ Does not replace the MCP server (complements it)
❌ Does not include full OAuthUtils.js file (links to source)
❌ Does not copy all API documentation (uses MCP for latest)

Instead: Provides curated guides, patterns, and pointers to authoritative sources.

Examples of Skill in Action

Example 1: OAuth Implementation

You: "How do I add Google Drive OAuth to my add-on?"

Skill Response:

  • References oauth-implementation.md
  • Provides Google Drive OAuth config
  • Shows PKCE flow code
  • Links to OAuthUtils.js helper
  • Explains manifest.json updates

Example 2: Code Samples

You: "I need an example of client storage"

Skill Response:

  • References code-samples.md
  • Points to use-client-storage sample
  • Describes what it demonstrates
  • Provides GitHub clone command
  • Explains how to run the sample

Example 3: Latest API

You: "What parameters does addAudio() take?"

Skill Response:

  • Queries MCP server for latest docs
  • Returns API signature
  • Notes that title is MANDATORY
  • Provides code example

Contributing

Contributions welcome! If you have improvements, additional patterns, or updated samples:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

Please ensure:

  • No duplication of full sample code (link instead)
  • Patterns are production-tested
  • Documentation is clear and concise

Related Resources

License

MIT License - see LICENSE file for details.

Author

Geoffrey Nwachukwu
Created for the Adobe Express developer community.

Acknowledgments

  • Adobe Express team for the excellent documentation and MCP server
  • Adobe Express add-on samples repository contributors
  • Anthropic for creating the Agent Skills specification
  • Agent Skills community (Cursor, GitHub Copilot, Windsurf, Claude, Continue.dev, Google Antigravity users)

Made with ❀️ for Adobe Express developers

If this skill helps you, please ⭐ star the repository and share with other developers!

About

Agent Skill for AI coding assistants (Cursor, Copilot, Windsurf, Claude) - Adobe Express add-on development with OAuth patterns and code samples

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published