contribution-submit
Creates or updates a Drupal merge request and generates the AI-disclosure comment at the policy threshold. Use when the user runs /drupal-ai-contrib:submit or asks to submit, open, or update a Drupal merge request or patch. Creates the cross-project MR via the drupal-gitlab skill
Install
npx skills add https://github.com/camoa/claude-skills/tree/main/drupal-ai-contrib/skills/contribution-submit
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install camoa-claude-skills@llmmart
git clone https://github.com/camoa/claude-skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole camoa/claude-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Contribution Submit (worker skill)
Creates or updates the merge request and prepares the required AI disclosure.
Backs /drupal-ai-contrib:submit. Load the knowledge layer via dev-guides-navigator:
drupal/contributing-with-ai/merge-request-workflow,
drupal/contributing/issue-forks-merge-requests,
drupal/contributing-with-ai/commit-messages,
drupal/contributing-with-ai/disclosure-checkboxes,
drupal/contributing/contribution-etiquette-rtbc-credit.
Preconditions — point, never refuse
submit runs whatever the prior state. But before creating the MR, check and surface:
- Has
verifybeen run, with its gates green? If not, say so — submitting unverified work is exactly the drive-by behavior the AI policy lists as unacceptable. - Has
reviewbeen run? Surface it if not. - Is the green
verifystill valid? Run${CLAUDE_PLUGIN_ROOT}/scripts/reverify-list.sh. If it prints any path, those files were edited afterverifylast passed — the green is stale. Surface the stale paths and recommend re-runningverifybefore submitting. A pre-edit green is not evidence for the current code (guardrails Rule 3). - Is the
reviewstill valid? Pipe the contribution's changed files to the review marker:git diff --name-only <target-branch>...<issue-fork-branch> | ${CLAUDE_PLUGIN_ROOT}/scripts/review-mark.sh. If it prints any path, those files were edited afterreviewlast ran — the review artifact is stale. Surface: "Review artifact is stale — files modified since the last/drupal-ai-contrib:review. Re-run review, or acknowledge and proceed." Require an explicit acknowledgement; never a hard block. (Ifreviewnever ran the marker is absent and prints nothing — the "Hasreviewbeen run?" point above covers that case.)
If a precondition is unmet, report it and let the contributor decide — do not silently block. The contributor may have evidence from another path.
Procedure
1. Confirm the branch and target
The issue-fork branch (issue-number in the name) and the target branch — the most
recent development branch (main for core; per-project for contrib). Draft vs. ready:
open as draft while work continues; mark ready when the issue moves to Needs review.
2. The AI-disclosure decision — policy-driven
Determine whether AI generated a significant portion — whole functions, classes, architectural scaffolding, or extensive docblocks. Single-line autocomplete is exempt. (These examples are illustrative — the live policy fetched below is authoritative.)
- If yes: prepare the disclosure in both places the policy requires — the issue
disclosure checkboxes (AI Assisted Code / AI Generated Code / Vibe Coded, as
applicable) and the MR description, including the
AI-Generated: Yes (...)comment in the policy's format. - If no: record that the threshold was assessed and not crossed.
Fetch the current policy state via the drupal-ai-contrib:ai-policy-checker agent
(Task tool) — do not rely on hard-coded thresholds; the policy moves.
3. Commit messages
Attribute AI involvement in commit messages per the commit-messages dev-guide. Keep the contributor as the responsible author — "the AI wrote it" is never a defense.
4. Create or update the MR
Migrated (GitLab) project — delegate MR create/update to the drupal-gitlab
skill (its references/merge-requests.md). Drupal MRs go from the issue fork to the
upstream project (cross-project), which glab mr create cannot do — drupal-gitlab
creates them via glab api … /projects/issue%2F<project>-<id>/merge_requests with an
explicit target_project_id, confirming a 201 (a write misdirected to git.drupal.org
silently degrades to a 200 + list, creating nothing). Reads — confirming and reporting
an existing MR — stay on drupalorg mr:list / mr:status (no-auth) or glab mr view.
Legacy-queue project: there is no GitLab MR — follow the classic patch/queue flow via
drupalorg / the web UI. See ${CLAUDE_PLUGIN_ROOT}/skills/drupal-ai-contrib/references/drupalorg-cli.md
§Hybrid model.
Write-token safety (from drupal-gitlab, the binding authority): a GitLab write
token is not project-scoped — it reaches every repo you can write to. Confirm the
target repo/branch, never push to a protected branch without explicit human approval,
and default to the issue fork even as a maintainer. API/CLI merges are blocked on
git.drupalcode.org — merge via the web UI only; never claim a merge you cannot perform.
Before any shell-out, validate identifiers against an explicit pattern — issue IDs
^[0-9]+$, project machine-names ^[a-z][a-z0-9_]*$ — and reject non-matching values;
never interpolate unsanitized input. Credentials are the contributor's own — never stored
or transmitted.
The MR description states: what the change does, the issue it resolves, the AI
disclosure (§2), and how it was verified (cite the captured verify artifacts).
5. Status & RTBC guidance — dual-mode
Set the issue status correctly (Needs review when the MR is ready). Surface RTBC
discipline: RTBC asserts the full checklist (tests pass, phpcs clean, threads
resolved, gates passed for core) — never just a code read, never self-RTBC. drupal.org
classic queue and GitLab state::* labels differ — handle the project's actual system.
6. Report
Summarize: the MR URL, target branch, the disclosure decision and where it was placed,
the issue status set, and the next step (pipeline — the real pipeline is the
authoritative final gate).
No overclaiming
Never imply Drupal "endorses AI contributions", never guarantee MR acceptance, never make GPL or provenance guarantees. The contributor is fully responsible for the submission, including copyright and licensing.
Examples
Example 1: significant AI portion → disclosure required
Trigger: /drupal-ai-contrib:submit 3456789
Actions:
- Assess: AI generated a whole service class → over the "significant portion" threshold.
- Prepare the issue disclosure checkboxes and the
AI-Generated: Yes (...)comment in the MR description; fetch the current policy viadrupal-ai-contrib:ai-policy-checker. Result: The MR opens with disclosure in both required places.
Example 2: submitting before verify
Trigger: /drupal-ai-contrib:submit with no green verify run.
Actions:
- Surface that
verifyhas not produced green gates. - Report it plainly; let the contributor decide whether to proceed. Result: No silent block — but the drive-by risk is named.
Troubleshooting
| Situation | Handling |
|---|---|
verify / review not run |
Surface it; report, do not refuse — the contributor decides. |
Files changed since the last review |
review-mark.sh prints the stale paths — surface the stale-review warning and require an acknowledgement; never block. Re-running review re-stamps the marker. |
drupalorg not installed |
Surface the install steps from references/drupalorg-cli.md; do not fabricate an MR URL. |
git push to the issue fork rejected |
The drupal.org SSH key is likely missing/unregistered — point at setup §5 and references/drupalorg-cli.md §Authentication. No push, no MR. |
MR-create call returns 200 + a list (nothing created) |
The glab api write was misdirected to git.drupal.org — it must go to git.drupalcode.org. Re-issue and confirm a 201. See drupal-gitlab → references/merge-requests.md. |
glab not installed / unauthenticated for writes |
Migrated-project MR creation needs glab + a write-scoped token — glab auth login --hostname git.drupalcode.org; point at setup. Reads/reporting still work via drupalorg. |
| Disclosure threshold ambiguous | Fetch the live policy via drupal-ai-contrib:ai-policy-checker; when still unclear, disclose. |
Project uses GitLab state::* labels |
Set the GitLab scoped label, not a classic-queue status. |
Files (claude-skills)
-
SKILL.md 8.4 KB
--- name: contribution-submit description: "Creates or updates a Drupal merge request and generates the AI-disclosure comment at the policy threshold. Use when the user runs /drupal-ai-contrib:submit or asks to submit, open, or update a Drupal merge request or patch. Creates the cross-project MR via the drupal-gitlab skill (glab); wraps drupalorg-cli for no-auth reads; surfaces status and RTBC guidance." version: 0.1.1 model: inherit user-invocable: false --- # Contribution Submit (worker skill) Creates or updates the merge request and prepares the required AI disclosure. Backs `/drupal-ai-contrib:submit`. Load the knowledge layer via `dev-guides-navigator`: `drupal/contributing-with-ai/merge-request-workflow`, `drupal/contributing/issue-forks-merge-requests`, `drupal/contributing-with-ai/commit-messages`, `drupal/contributing-with-ai/disclosure-checkboxes`, `drupal/contributing/contribution-etiquette-rtbc-credit`. ## Preconditions — point, never refuse `submit` runs whatever the prior state. But before creating the MR, check and surface: - Has `verify` been run, with its gates green? If not, say so — submitting unverified work is exactly the drive-by behavior the AI policy lists as unacceptable. - Has `review` been run? Surface it if not. - **Is the green `verify` still valid?** Run `${CLAUDE_PLUGIN_ROOT}/scripts/reverify-list.sh`. If it prints any path, those files were edited **after** `verify` last passed — the green is stale. Surface the stale paths and recommend re-running `verify` before submitting. A pre-edit green is not evidence for the current code (guardrails Rule 3). - **Is the `review` still valid?** Pipe the contribution's changed files to the review marker: `git diff --name-only <target-branch>...<issue-fork-branch> | ${CLAUDE_PLUGIN_ROOT}/scripts/review-mark.sh`. If it prints any path, those files were edited **after** `review` last ran — the review artifact is stale. Surface: *"Review artifact is stale — files modified since the last `/drupal-ai-contrib:review`. Re-run review, or acknowledge and proceed."* Require an explicit acknowledgement; **never a hard block**. (If `review` never ran the marker is absent and prints nothing — the "Has `review` been run?" point above covers that case.) If a precondition is unmet, **report it and let the contributor decide** — do not silently block. The contributor may have evidence from another path. ## Procedure ### 1. Confirm the branch and target The issue-fork branch (issue-number in the name) and the **target branch** — the most recent development branch (`main` for core; per-project for contrib). Draft vs. ready: open as draft while work continues; mark ready when the issue moves to Needs review. ### 2. The AI-disclosure decision — policy-driven Determine whether AI generated a **significant portion** — whole functions, classes, architectural scaffolding, or extensive docblocks. Single-line autocomplete is exempt. (These examples are illustrative — the live policy fetched below is authoritative.) - If **yes**: prepare the disclosure in **both** places the policy requires — the issue **disclosure checkboxes** (AI Assisted Code / AI Generated Code / Vibe Coded, as applicable) **and** the MR description, including the `AI-Generated: Yes (...)` comment in the policy's format. - If **no**: record that the threshold was assessed and not crossed. Fetch the **current** policy state via the `drupal-ai-contrib:ai-policy-checker` agent (Task tool) — do not rely on hard-coded thresholds; the policy moves. ### 3. Commit messages Attribute AI involvement in commit messages per the commit-messages dev-guide. Keep the contributor as the responsible author — "the AI wrote it" is never a defense. ### 4. Create or update the MR **Migrated (GitLab) project** — delegate MR create/update to the **`drupal-gitlab`** skill (its `references/merge-requests.md`). Drupal MRs go **from the issue fork to the upstream project** (cross-project), which **`glab mr create` cannot do** — `drupal-gitlab` creates them via `glab api … /projects/issue%2F<project>-<id>/merge_requests` with an explicit `target_project_id`, confirming a `201` (a write misdirected to `git.drupal.org` silently degrades to a `200` + list, creating nothing). Reads — confirming and reporting an existing MR — stay on `drupalorg mr:list` / `mr:status` (no-auth) or `glab mr view`. **Legacy-queue project**: there is no GitLab MR — follow the classic patch/queue flow via `drupalorg` / the web UI. See `${CLAUDE_PLUGIN_ROOT}/skills/drupal-ai-contrib/references/drupalorg-cli.md` §Hybrid model. **Write-token safety (from `drupal-gitlab`, the binding authority):** a GitLab write token is **not** project-scoped — it reaches every repo you can write to. Confirm the target repo/branch, **never push to a protected branch without explicit human approval**, and default to the issue fork even as a maintainer. API/CLI **merges are blocked** on `git.drupalcode.org` — merge via the web UI only; never claim a merge you cannot perform. Before any shell-out, validate identifiers against an explicit pattern — issue IDs `^[0-9]+$`, project machine-names `^[a-z][a-z0-9_]*$` — and reject non-matching values; never interpolate unsanitized input. Credentials are the contributor's own — never stored or transmitted. The MR description states: what the change does, the issue it resolves, the AI disclosure (§2), and how it was verified (cite the captured `verify` artifacts). ### 5. Status & RTBC guidance — dual-mode Set the issue status correctly (Needs review when the MR is ready). Surface RTBC discipline: RTBC asserts the **full checklist** (tests pass, phpcs clean, threads resolved, gates passed for core) — never just a code read, never self-RTBC. drupal.org classic queue and GitLab `state::*` labels differ — handle the project's actual system. ### 6. Report Summarize: the MR URL, target branch, the disclosure decision and where it was placed, the issue status set, and the next step (`pipeline` — the real pipeline is the authoritative final gate). ## No overclaiming Never imply Drupal "endorses AI contributions", never guarantee MR acceptance, never make GPL or provenance guarantees. The contributor is fully responsible for the submission, including copyright and licensing. ## Examples ### Example 1: significant AI portion → disclosure required **Trigger:** `/drupal-ai-contrib:submit 3456789` **Actions:** 1. Assess: AI generated a whole service class → over the "significant portion" threshold. 2. Prepare the issue disclosure checkboxes **and** the `AI-Generated: Yes (...)` comment in the MR description; fetch the current policy via `drupal-ai-contrib:ai-policy-checker`. **Result:** The MR opens with disclosure in both required places. ### Example 2: submitting before verify **Trigger:** `/drupal-ai-contrib:submit` with no green `verify` run. **Actions:** 1. Surface that `verify` has not produced green gates. 2. Report it plainly; let the contributor decide whether to proceed. **Result:** No silent block — but the drive-by risk is named. ## Troubleshooting | Situation | Handling | |-----------|----------| | `verify` / `review` not run | Surface it; report, do not refuse — the contributor decides. | | Files changed since the last `review` | `review-mark.sh` prints the stale paths — surface the stale-review warning and require an acknowledgement; never block. Re-running `review` re-stamps the marker. | | `drupalorg` not installed | Surface the install steps from `references/drupalorg-cli.md`; do not fabricate an MR URL. | | `git push` to the issue fork rejected | The drupal.org SSH key is likely missing/unregistered — point at `setup` §5 and `references/drupalorg-cli.md` §Authentication. No push, no MR. | | MR-create call returns `200` + a list (nothing created) | The `glab api` write was misdirected to `git.drupal.org` — it must go to `git.drupalcode.org`. Re-issue and confirm a `201`. See `drupal-gitlab` → `references/merge-requests.md`. | | `glab` not installed / unauthenticated for writes | Migrated-project MR creation needs `glab` + a write-scoped token — `glab auth login --hostname git.drupalcode.org`; point at `setup`. Reads/reporting still work via `drupalorg`. | | Disclosure threshold ambiguous | Fetch the live policy via `drupal-ai-contrib:ai-policy-checker`; when still unclear, disclose. | | Project uses GitLab `state::*` labels | Set the GitLab scoped label, not a classic-queue status. |
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.