feat: Claude code plugin

[tolusha]

How to test

Run claude to add and install pluign:

/plugin marketplace add https://github.com/devfile/claude-plugin.git#skills
/plugin install devfile@devfile 
/reload-plugins

Invoke the skill and ask to add a simple devfile:

/devfile:devfile 

Chat with claude

details

---

add simple devfile

Claude generates a base devfile using the default template:

  schemaVersion: 2.3.0
  metadata:
    name: claude-plugin
  components:
    - name: tools
      container:
        image: quay.io/devfile/universal-developer-image:latest

add postgres component

Claude reads the schema reference and adds a postgres container with env vars, endpoint, and a persistent volume:

    - name: postgres
      container:
        image: docker.io/library/postgres:16
        command: ['sleep', 'infinity']
        env:
          - name: POSTGRES_USER
            value: user
          - name: POSTGRES_PASSWORD
            value: password
          - name: POSTGRES_DB
            value: db
        endpoints: 
          - name: postgres
            targetPort: 5432
            exposure: internal
        volumeMounts:
          - name: pgdata
            path: /var/lib/postgresql/data
    - name: pgdata
      volume:
        size: 1Gi

add memory cpu limits

Claude adds resource constraints to the postgres container:

        memoryLimit: 512Mi
        memoryRequest: 256Mi
        cpuLimit: '1'
        cpuRequest: 250m

---

Summary by CodeRabbit

• New Features

  • Added a devfile plugin entry to the Claude Code marketplace (devfile plugin, v2.3.0) for creating, modifying, and reviewing devfile configurations.

• Documentation

  • Added a full devfile schema reference and a detailed skill guide with templates, authoring rules, and usage guidance.
  • Expanded README into a marketplace listing with installation and registration instructions.

[openshift-ci]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: tolusha

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: de3a5f5b-2beb-41c4-9b57-3ef05a51ebc8

📥 Commits

Reviewing files that changed from the base of the PR and between d7efcec and 4fe3c38.

📒 Files selected for processing (1)

• plugins/devfile/skills/devfile/devfile-schema-reference.md

✅ Files skipped from review due to trivial changes (1)

• plugins/devfile/skills/devfile/devfile-schema-reference.md

---

📝 Walkthrough

Walkthrough

This PR adds marketplace registration and README listing, plugin metadata for a devfile Claude plugin, a comprehensive SKILL guide with authoring and override rules, and a full Devfile v2.3.0 schema reference.

Changes

Devfile Claude Plugin Introduction

Layer / File(s)	Summary
Plugin registration and marketplace metadata .claude-plugin/marketplace.json, plugins/devfile/.claude-plugin/plugin.json, README.md	Adds marketplace metadata registering the devfile plugin, introduces plugin.json with name/description/author, and expands README into a marketplace listing with installation instructions.
Devfile skill guide and authoring constraints plugins/devfile/skills/devfile/SKILL.md	Adds a SKILL describing required full-devfile YAML output, default template, registry-based generation flow, container/volume/image authoring rules, variable substitution constraints, reserved environment variables, and pod/container override merge behavior and restricted properties.
Devfile schema reference documentation plugins/devfile/skills/devfile/devfile-schema-reference.md	Adds a full Devfile v2.3.0 schema reference covering top-level properties, metadata, components (container, Kubernetes/OpenShift, image, volume, endpoints), commands, events, projects, starter/dependent projects, parent templates, examples, and field constraints.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

In burrows of bytes I hum and write,
A devfile blooms in morning light,
Marketplace gates now open wide,
Templates, rules, and schema beside,
Hop forth, compile — the build's delight! 🐇

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Title check	❓ Inconclusive	The title 'feat: Claude code plugin' is vague and generic, failing to clearly describe the specific contribution of this changeset.	Consider a more specific title such as 'feat: Add Claude Code plugin for Devfile YAML generation and modification' to better convey the main purpose and scope of the changes.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch skills

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@plugins/devfile/skills/devfile/devfile-schema-reference.md`:
- Line 211: Fix the wording and heading consistency in the devworkspace section
intros: change the phrase "sources locations" to "source locations" in the
Projects description and rename any heading labeled "Parents" to "Parent" so it
matches the schema field name `parent`; apply the same edits to the other
occurrences referenced around the headings and paragraph blocks (the lines near
the Projects intro and the sections that mention `parent`) to keep phrasing and
heading names consistent across the file.

In `@README.md`:
- Around line 17-27: The fenced code blocks containing the shell commands
"/plugin marketplace add" and "/plugin install devfile@devfile" are missing a
language identifier; update those three backtick fences to include a shell
language (e.g., bash) so they read ```bash instead of ``` to satisfy
markdownlint MD040 and ensure correct syntax highlighting for the command
examples.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 39026fbe-d986-47e7-b795-da0ef37a883c

📥 Commits

Reviewing files that changed from the base of the PR and between 03801b2 and d7efcec.

📒 Files selected for processing (5)

• .claude-plugin/marketplace.json
• README.md
• plugins/devfile/.claude-plugin/plugin.json
• plugins/devfile/skills/devfile/SKILL.md
• plugins/devfile/skills/devfile/devfile-schema-reference.md

[dkwon17]

In devfile-schema-reference.md and SKILL.md, could we replace devworkspace with developer environment?

[tolusha]

@dkwon17
[1] it is moustly about devworkspace not developer environment

[1] https://devfile.io/devfile-schemas/2.3.0.json