Skip to content

[External Plugin]: figma-maxxing #4539

Open

Description

@thiagoxikota

Plugin name

figma-maxxing

Short description

8 Agent Skills for agents that edit real Figma files. They instruct the agent to inspect a file before writing, read back changes and report missing handoff states.

GitHub repository

thiagoxikota/figma-maxxing

Plugin path inside the repository

No response

Ref to review

v1.2.0

Commit SHA to review

42391e382a192ddba67512bd81b60f51a0e70c6e

Version

1.2.0

License identifier

MIT

Author name

Thiago Xikota

Author URL

https://github.com/thiagoxikota

Homepage URL

https://github.com/thiagoxikota/figma-maxxing

Keywords

figma, design-systems, handoff, agent-skills

Additional notes for reviewers

Codex drafted this submission for repository owner Thiago Xikota.

The plugin contains Markdown skills. It does not bundle an MCP server or install hooks. Users connect their own agent to Figma's official MCP server or the third-party figma-console-mcp bridge. The bridge recovery helpers are macOS only. The repository documents the limitations of each route in docs/works-with.md.

On 2026-10-05, Copilot CLI installed all 8 skills in a clean folder. That tested installation, not end-to-end execution of every skill in Copilot. Most operating rules came from the author's work in real files. The public repository explains the demo audit and its limitations; it does not claim complete defect coverage. Tests check every cited Plugin API name against the pinned typings. See README.md and docs/works-with.md at the submitted immutable commit.

The first quality-gate run rejected source.path "/" in the install smoke test, although the submission guide allows it. The root path field is now empty. The same run also rejected references to sibling skills under valid-refs: the bundle shares figma-canon references across its skills. Those files exist in the repository, but vally requires each reference to remain inside its individual skill directory. This submission remains blocked by that packaging requirement.

MIT. Not affiliated with Figma.

Submission checklist

  • The plugin lives in a public GitHub repository.
  • The ref and/or sha I provided is immutable (release tag and/or full 40-character commit SHA), not a branch.
  • This submission follows this repository's contribution, security, and responsible AI policies.
  • This plugin is not already listed in the Awesome Copilot marketplace.

Activity

  1. github-actions commented on Oct 6, 2026

    @github-actions
    Contributor

    🔴 Contributor Reputation Check: HIGH risk

    Check Risk
    Profile HIGH
    Credential audit NONE

    Maintainers: please review this contributor before merging.
    See the workflow run for full details.
    Automated check powered by AGT.

  2. added
    needs-review:HIGHContributor reputation check flagged HIGH risk
    external-pluginPublic external plugin submission
    requires-submitter-fixesSubmission has quality-gate findings that submitter must fix before maintainer review
    on Oct 6, 2026
  3. github-actions commented on Oct 6, 2026

    @github-actions
    Contributor

    🛑 External plugin intake failed (submitter fixes required)

    This submission passed metadata validation, but quality gates found issues that must be fixed before it can move to maintainer review. Update the issue details or source plugin and then comment /rerun-intake.

    View workflow run · Download full quality gate logs

    Reviewer signals

    These are non-blocking heuristics for maintainer review; they are not evidence of misconduct or low quality.

    Signal Result
    Repository age 4 day(s)
    Repository activity repository is 4 day(s) old; 0 watchers
    Repository counts 7 stars · 0 watchers · 1 forks · 1 open issues/PRs
    Homepage heuristics ⚠️ pricing

    Quality gate summary

    Legend: ✅ pass · ⚠️ warning · 🛑 fail

    Gate Status
    spec compliance (non-blocking) ✅ pass
    vally lint 🛑 fail
    install smoke test ✅ pass
    version match ✅ pass
    ref/sha consistency ✅ pass
    canvas structure ⚪ not_run
    • spec compliance: pass
    • vally lint: fail
    • install smoke test: pass
    • version match: pass
    • ref/sha consistency: pass
    • canvas structure: not_run
    • overall: fail
    spec compliance output (✅ pass)
    Agent Plugins v1.0.0 manifest checks passed for plugin.json.
    
    vally lint output (🛑 fail)
    ✅ figma-bridge-doctor (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ✅ figma-canon (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ❌ figma-click-flow (1/2 checks passed, 1 failed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✗ [valid-refs] 1 of 1 skill(s) have invalid file references.
            ✗ valid-refs: Found 6 invalid file reference(s): ../figma-canon/references/rate-limit-recovery.md (outside-skill-dir) at line 25, ../figma-canon/references/naming-canon.md (outside-skill-dir) at line 55, ../figma-canon/references/figma-execute-atomicity.md (outside-skill-dir) at line 143, ../figma-canon/references/plugin-api-anomalies.md (outside-skill-dir) at line 143, ../figma-canon/references/rate-limit-recovery.md (outside-skill-dir) at line 147, ../figma-canon/references/figma-execute-atomicity.md (outside-skill-dir) at line 197.
    ❌ figma-comment-fix-loop (1/2 checks passed, 1 failed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✗ [valid-refs] 1 of 1 skill(s) have invalid file references.
            ✗ valid-refs: Found 7 invalid file reference(s): ../figma-canon/references/rate-limit-recovery.md (outside-skill-dir) at line 29, ../figma-canon/references/rate-limit-recovery.md (outside-skill-dir) at line 67, ../figma-canon/references/plugin-api-anomalies.md (outside-skill-dir) at line 83, ../figma-canon/references/field-notes.md (outside-skill-dir) at line 84, ../figma-canon/references/plugin-api-anomalies.md (outside-skill-dir) at line 97, ../figma-canon/references/plugin-api-data.md (outside-skill-dir) at line 98, ../figma-canon/references/plugin-api-anomalies.md (outside-skill-dir) at line 98.
    ❌ figma-handoff-gate (1/2 checks passed, 1 failed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✗ [valid-refs] 1 of 1 skill(s) have invalid file references.
            ✗ valid-refs: Found 19 invalid file reference(s): ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 37, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 37, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 49, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 62, ../figma-canon/references/ai-slop-signatures.md (outside-skill-dir) at line 77, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 89, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 94, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 102, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 107, ../figma-canon/references/ai-slop-signatures.md (outside-skill-dir) at line 107, ../figma-canon/references/state-coverage.md (outside-skill-dir) at line 145, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 152, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 157, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 161, ../figma-canon/references/plugin-api-anomalies.md (outside-skill-dir) at line 168, ../figma-canon/references/plugin-api-core.md (outside-skill-dir) at line 185, ../figma-canon/references/plugin-api-anomalies.md (outside-skill-dir) at line 202, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 266, ../figma-canon/references/ai-slop-signatures.md (outside-skill-dir) at line 266.
    ❌ figma-orient (1/2 checks passed, 1 failed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✗ [valid-refs] 1 of 1 skill(s) have invalid file references.
            ✗ valid-refs: Found 6 invalid file reference(s): ../figma-canon/references/figma-execute-atomicity.md (outside-skill-dir) at line 50, ../figma-canon/references/plugin-api-anomalies.md (outside-skill-dir) at line 52, ../figma-canon/references/plugin-api-core.md (outside-skill-dir) at line 53, ../figma-canon/references/field-notes.md (outside-skill-dir) at line 57, ../figma-canon/references/inspect-protocol.md (outside-skill-dir) at line 59, ../figma-canon/references/inspect-protocol.md (outside-skill-dir) at line 150.
    ❌ figma-preflight (1/2 checks passed, 1 failed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✗ [valid-refs] 1 of 1 skill(s) have invalid file references.
            ✗ valid-refs: Found 6 invalid file reference(s): ../figma-bridge-doctor/scripts/figma-status.sh (outside-skill-dir) at line 73, ../figma-canon/references (outside-skill-dir) at line 141, ../figma-canon/references/state-coverage.md (outside-skill-dir) at line 155, ../figma-bridge-doctor/scripts/figma-status.sh (outside-skill-dir) at line 225, ../figma-bridge-doctor/references/rival-write-audit.md (outside-skill-dir) at line 253, ../figma-canon/references/naming-canon.md (outside-skill-dir) at line 304.
    ❌ figma-slop-check (1/2 checks passed, 1 failed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✗ [valid-refs] 1 of 1 skill(s) have invalid file references.
            ✗ valid-refs: Found 11 invalid file reference(s): ../figma-canon/references/ai-slop-signatures.md (outside-skill-dir) at line 62, ../figma-canon/references/quality-rubric.md (outside-skill-dir) at line 63, ../figma-canon/references/naming-canon.md (outside-skill-dir) at line 64, ../figma-canon/references/state-coverage.md (outside-skill-dir) at line 65, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 66, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 84, ../figma-canon/references/naming-canon.md (outside-skill-dir) at line 115, ../figma-canon/references/handoff-format.md (outside-skill-dir) at line 136, ../figma-canon/references/quality-rubric.md (outside-skill-dir) at line 172, ../figma-canon/references/state-coverage.md (outside-skill-dir) at line 175, ../figma-canon/references/plugin-api-anomalies.md (outside-skill-dir) at line 270.
    
    8 skill(s) linted, 2 passed, 6 failed
    
    install smoke test output (✅ pass)
    Install smoke test succeeded. Verified /tmp/external-plugin-quality-lHaSQk/copilot-home/.copilot/installed-plugins/external-plugin-intake/figma-maxxing/plugin.json.
    
    Version match output
    - v1.2.0: matched version "1.2.0" at "plugin.json".
    - 42391e382a192ddba67512bd81b60f51a0e70c6e: matched version "1.2.0" at "plugin.json".
    
    Ref/SHA consistency output
    source.ref "v1.2.0" resolves to the same commit as source.sha "42391e382a192ddba67512bd81b60f51a0e70c6e".
    
    Canvas structure output
    Canvas structure gate skipped because plugin is not tagged with "canvas".
    

    Canonical external.json payload

    {
      "name": "figma-maxxing",
      "description": "8 Agent Skills for agents that edit real Figma files. They instruct the agent to inspect a file before writing, read back changes and report missing handoff states.",
      "version": "1.2.0",
      "author": {
        "name": "Thiago Xikota",
        "url": "https://github.com/thiagoxikota"
      },
      "repository": "https://github.com/thiagoxikota/figma-maxxing",
      "homepage": "https://github.com/thiagoxikota/figma-maxxing",
      "license": "MIT",
      "keywords": [
        "figma",
        "design-systems",
        "handoff",
        "agent-skills"
      ],
      "source": {
        "source": "github",
        "repo": "thiagoxikota/figma-maxxing",
        "ref": "v1.2.0",
        "sha": "42391e382a192ddba67512bd81b60f51a0e70c6e"
      }
    }
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    external-pluginPublic external plugin submissionneeds-review:HIGHContributor reputation check flagged HIGH riskrequires-submitter-fixesSubmission has quality-gate findings that submitter must fix before maintainer review

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions