Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions .gemini-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
{
"name": "monday-work-management",
"displayName": "monday.com",
"version": "1.0.0",
"description": "Plan and track work in monday.com from Gemini: set up boards, create, update and assign items, get project status reports, write docs, and build forms that turn requests into items.",
"author": {
"name": "monday.com",
"email": "support@monday.com",
"url": "https://monday.com"
},
"repository": "https://github.com/mondaycom/gemini-plugin",
"homepage": "https://monday.com/w/mcp",
"license": "MIT",
"keywords": [
"monday",
"project-management",
"work-management",
"tasks",
"boards",
"status-report",
"docs",
"forms"
],
"skills": [
"./skills/monday-onboard-to-monday/SKILL.md",
"./skills/monday-task-management/SKILL.md",
"./skills/monday-board-setup/SKILL.md",
"./skills/monday-project-status-report/SKILL.md",
"./skills/monday-docs-collaborator/SKILL.md",
"./skills/monday-forms-builder/SKILL.md"
],
"mcpServers": "./.mcp.json"
}
31 changes: 31 additions & 0 deletions .github/workflows/check.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
name: Check plugin

# skills/ must be exactly what scripts/sync-skills.sh produces from the ref pinned in skills.json, and
# the plugin must pass scripts/check-skills.js (Google's offline plugin rules). Re-running the sync
# checks both: it runs the checker, and any hand edit to skills/ shows up as a diff.

on:
pull_request:
push:
branches: [main]

permissions:
contents: read

jobs:
check:
name: Skills in sync and plugin rules
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4

- name: Re-sync skills and check the plugin
run: scripts/sync-skills.sh

- name: Fail if skills/ differs from the pinned ref
run: |
if [ -n "$(git status --porcelain -- skills)" ]; then
git status --short -- skills
echo "::error::skills/ does not match mondaycom/skills at the ref in skills.json. Change the skill in mondaycom/skills, bump the ref and run scripts/sync-skills.sh."
exit 1
fi
8 changes: 8 additions & 0 deletions .mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"mcpServers": {
"monday": {
"type": "http",
"url": "https://mcp.monday.com/mcp"
}
}
}
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# Changelog

All notable changes to this plugin are documented here. Versions follow [Semantic Versioning](https://semver.org).

## 1.0.0

- First release for Gemini Agent: the monday.com MCP server (`https://mcp.monday.com/mcp`) and six skills,
`monday-onboard-to-monday`, `monday-board-setup`, `monday-task-management`, `monday-project-status-report`,
`monday-docs-collaborator` and `monday-forms-builder`.
13 changes: 13 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Contributing

This repository is the monday.com plugin for Gemini Agent.

- **Skills** (`skills/`) are copied from [mondaycom/skills](https://github.com/mondaycom/skills) and must not be
edited here. `scripts/sync-skills.sh` adds the `prefix` from `skills.json` to each skill's folder and `name`,
because Gemini requires skill names to start with the partner brand. To change a skill, open a pull request in
mondaycom/skills. Once it is merged, bump `ref` in `skills.json` (and `skills`, to add or remove one), run
`scripts/sync-skills.sh` and open a pull request here with the result.
- **Everything else** (manifest, README, MCP configuration) is edited directly here through a pull request. Bump
`version` in `.gemini-plugin/plugin.json` and add a `CHANGELOG.md` entry with every release, then tag it
`v<version>`.
- **Product support:** [support.monday.com](https://support.monday.com).
4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,16 @@
# monday.com for Gemini

Bring monday.com into Gemini. Create, update and assign items, write docs and set up forms from a conversation.
Bring monday.com into Gemini. Set up boards, create, update and assign items, get status reports, write docs and set up forms from a conversation.

## What you get

- **monday.com MCP server**: the official monday.com MCP server (`https://mcp.monday.com/mcp`, Streamable HTTP,
OAuth), with tools for boards, items, columns, docs, forms, dashboards, workspaces and more.
- **Skills**
- `monday-onboard-to-monday`: first-run setup. Builds a board tailored to your work, with starter items and an automation.
- `monday-board-setup`: create a board with the right groups, columns and starter items.
- `monday-task-management`: create, update, assign and move items, with correct column-value formats.
- `monday-project-status-report`: status reports across boards: overdue items, blockers, workload and recent activity.
- `monday-docs-collaborator`: create, read, edit and comment on monday docs, including live column embeds and mentions.
- `monday-forms-builder`: create, edit and publish monday WorkForms.

Expand Down
154 changes: 154 additions & 0 deletions scripts/check-skills.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,154 @@
#!/usr/bin/env node
// Checks the plugin against the rules in Google's "Partner Plugin & Skill Best Practices Guide" that can be
// checked offline. Errors are the guide's hard limits and blocking security checks; warnings are its
// authoring standards. Exits 1 on any error.
//
// Usage: node scripts/check-skills.js [plugin-root]
"use strict";
const fs = require("fs");
const path = require("path");

const root = path.resolve(process.argv[2] || path.join(__dirname, ".."));
const errors = [];
const warnings = [];
const err = (where, msg) => errors.push(`${where}: ${msg}`);
const warn = (where, msg) => warnings.push(`${where}: ${msg}`);

const GOOGLE_1P = ["bigquery", "gemini", "vertex-ai", "looker", "gdrive"];
const INSTALL = /\b(brew install|npm (i|install)\b|npx |pip3? install|curl [^\n]*\|\s*(ba|z)?sh|wget [^\n]*\|\s*(ba|z)?sh)/i;
const INVISIBLE = /[\u200B-\u200F\u202A-\u202E\u2060-\u2064\uFEFF]/;
const HIDDEN_DIRECTIVE = /<\/?(IMPORTANT|SYSTEM)>/i;

function readJson(rel) {
try {
return JSON.parse(fs.readFileSync(path.join(root, rel), "utf8"));
} catch (e) {
err(rel, `cannot read: ${e.message}`);
return null;
}
}

// Minimal frontmatter reader for the two keys we check: plain scalars and folded/literal blocks.
function frontmatter(text) {
const m = text.match(/^---\n([\s\S]*?)\n---\n?/);
if (!m) return null;
const out = {};
const lines = m[1].split("\n");
for (let i = 0; i < lines.length; i++) {
const kv = lines[i].match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
if (!kv) continue;
let value = kv[2];
if (/^[>|][-+]?$/.test(value)) {
const block = [];
while (i + 1 < lines.length && (/^\s/.test(lines[i + 1]) || lines[i + 1] === "")) block.push(lines[++i].trim());
value = block.join(value.startsWith(">") ? " " : "\n").trim();
} else {
value = value.replace(/^(["'])(.*)\1$/, "$2");
}
out[kv[1]] = value;
}
return { data: out, body: text.slice(m[0].length) };
}

const manifest = readJson(".gemini-plugin/plugin.json");
const skillsConfig = readJson("skills.json");
const prefix = (skillsConfig && skillsConfig.prefix) || "";

if (manifest) {
for (const key of ["name", "displayName", "version", "description", "author", "skills", "mcpServers"]) {
if (manifest[key] === undefined) err("plugin.json", `missing "${key}"`);
}
if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(manifest.name || "")) err("plugin.json", "name must be kebab-case");
if (prefix && !(manifest.name || "").startsWith(prefix)) err("plugin.json", `name must start with "${prefix}" (CRIT-26a)`);
if (!/^\d+\.\d+\.\d+$/.test(manifest.version || "")) err("plugin.json", "version must be MAJOR.MINOR.PATCH");
for (const f of ["README.md", "CHANGELOG.md", "LICENSE"]) {
if (!fs.existsSync(path.join(root, f))) err(f, "missing");
}
const changelog = fs.existsSync(path.join(root, "CHANGELOG.md")) ? fs.readFileSync(path.join(root, "CHANGELOG.md"), "utf8") : "";
if (manifest.version && !changelog.includes(`## ${manifest.version}`)) err("CHANGELOG.md", `no entry for ${manifest.version}`);

let authorHost = "";
try {
authorHost = new URL(manifest.author.url).hostname.replace(/^www\./, "");
} catch {
err("plugin.json", "author.url must be a URL");
}
const mcp = readJson(String(manifest.mcpServers || ".mcp.json").replace(/^\.\//, ""));
for (const [id, server] of Object.entries((mcp && mcp.mcpServers) || {})) {
let url;
try {
url = new URL(server.url);
} catch {
err(".mcp.json", `${id}: url is not a URL`);
continue;
}
if (url.protocol !== "https:") err(".mcp.json", `${id}: url must use https (CRIT-23)`);
if (authorHost && !(url.hostname === authorHost || url.hostname.endsWith(`.${authorHost}`))) {
err(".mcp.json", `${id}: ${url.hostname} does not match author.url domain ${authorHost} (CRIT-26b)`);
}
}

const listed = new Set();
for (const rel of manifest.skills || []) {
const where = rel;
const file = path.join(root, rel);
if (!fs.existsSync(file)) {
err(where, "listed in plugin.json but missing");
continue;
}
const dir = path.basename(path.dirname(file));
listed.add(dir);
const text = fs.readFileSync(file, "utf8");
const fm = frontmatter(text);
if (!fm) {
err(where, "no YAML frontmatter");
continue;
}
const { name = "", description = "" } = fm.data;
if (name !== dir) err(where, `frontmatter name "${name}" does not match folder "${dir}"`);
if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(name) || name.length > 64) err(where, "name must be kebab-case, <= 64 chars");
if (prefix && !name.startsWith(prefix)) err(where, `name must start with "${prefix}" (CRIT-26a)`);
if (GOOGLE_1P.includes(name)) err(where, "name is a Google 1P name (CRIT-26a)");
if (!description) err(where, "description is empty");
if (description.length > 1024) err(where, `description is ${description.length} chars, max 1024`);
if (!/"[^"]+"/.test(description)) warn(where, "description has no quoted trigger phrases");
if (!/\b(don'?t|do not) use\b/i.test(description)) warn(where, `description has no "Don't use for..." boundary`);

const lines = text.split("\n").length;
const words = fm.body.split(/\s+/).filter(Boolean).length;
if (lines > 500) err(where, `${lines} lines, max 500`);
else if (lines > 300) warn(where, `${lines} lines, target 150-300`);
if (words >= 3000) err(where, `${words} words in the body, max 3,000`);

const skillDir = path.dirname(file);
for (const f of walk(skillDir)) {
const rel2 = path.relative(root, f);
const content = fs.readFileSync(f, "utf8");
if (INSTALL.test(content)) err(rel2, "contains a local install command");
if (INVISIBLE.test(content)) err(rel2, "contains invisible Unicode characters (CRIT-12-16)");
if (HIDDEN_DIRECTIVE.test(content)) err(rel2, "contains a hidden <IMPORTANT>/<SYSTEM> directive (CRIT-22)");
}
}
const skillsDir = path.join(root, "skills");
if (fs.existsSync(skillsDir)) {
for (const d of fs.readdirSync(skillsDir)) {
if (!listed.has(d)) err(`skills/${d}`, "not listed in plugin.json skills");
}
}
}

function walk(dir) {
return fs.readdirSync(dir, { withFileTypes: true }).flatMap((e) => {
const p = path.join(dir, e.name);
if (e.isSymbolicLink()) {
err(path.relative(root, p), "symlinks are not allowed (CRIT-01-20)");
return [];
}
return e.isDirectory() ? walk(p) : [p];
});
}

for (const w of warnings) console.log(`warning ${w}`);
for (const e of errors) console.log(`error ${e}`);
console.log(`${errors.length} error(s), ${warnings.length} warning(s)`);
process.exit(errors.length ? 1 : 0);
67 changes: 67 additions & 0 deletions scripts/sync-skills.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
#!/usr/bin/env bash
# Syncs skills/ from the repo and commit pinned in skills.json, then checks them against Gemini's skill rules.
#
# mondaycom/skills is the single source of truth for skill content. Never edit skills/ by hand:
# change the skill in mondaycom/skills, bump "ref" (and "skills" if needed) in skills.json, run this
# script and commit the result.
#
# Gemini requires every skill name to start with the partner brand, while mondaycom/skills keeps the
# unprefixed names its other consumers install by. So each skill is copied to skills/<prefix><skill>/,
# and its frontmatter name and any mention of another synced skill get the same prefix.
#
# Usage: scripts/sync-skills.sh
# Env overrides (for testing an unmerged skills branch):
# SKILLS_REPO git URL or local path to use instead of skills.json "repo"
# SKILLS_REF commit or branch to use instead of skills.json "ref"
set -euo pipefail

ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"

case "${1:-}" in
-h|--help) sed -n '2,16p' "$0"; exit 0 ;;
"") ;;
*) echo "Unknown argument: $1" >&2; exit 1 ;;
esac

for cmd in git node perl; do
command -v "$cmd" >/dev/null || { echo "Missing required command: $cmd" >&2; exit 1; }
done

config() {
node -e '
const c = require(process.argv[1]); const v = c[process.argv[2]];
if (v === undefined || (Array.isArray(v) && v.length === 0)) { console.error(`skills.json: "${process.argv[2]}" is missing or empty`); process.exit(1); }
console.log(Array.isArray(v) ? v.join("\n") : v);
' "$ROOT/skills.json" "$1"
}
SKILLS_REPO="${SKILLS_REPO:-$(config repo)}"
SKILLS_REF="${SKILLS_REF:-$(config ref)}"
PREFIX="$(config prefix)"
SKILLS="$(config skills)"

[[ "$PREFIX" =~ ^[a-z0-9]+-$ ]] || { echo "Invalid prefix in skills.json: '$PREFIX'" >&2; exit 1; }

WORK_DIR="$(mktemp -d "${TMPDIR:-/tmp}/monday-skills.XXXXXX")"
trap 'rm -rf "$WORK_DIR"' EXIT

echo "Fetching skills from $SKILLS_REPO @ $SKILLS_REF"
git clone --quiet --no-checkout "$SKILLS_REPO" "$WORK_DIR/src"
git -C "$WORK_DIR/src" checkout --quiet "$SKILLS_REF"

while IFS= read -r skill; do
[[ "$skill" =~ ^[a-z0-9-]+$ ]] || { echo "Invalid skill name in skills.json: '$skill'" >&2; exit 1; }
[ -f "$WORK_DIR/src/skills/$skill/SKILL.md" ] || { echo "Skill not found at $SKILLS_REF: $skill" >&2; exit 1; }
done <<< "$SKILLS"

rm -rf "$ROOT/skills"
mkdir -p "$ROOT/skills"
NAMES_ALT="$(echo "$SKILLS" | paste -sd '|' -)"
while IFS= read -r skill; do
dest="$ROOT/skills/$PREFIX$skill"
cp -R "$WORK_DIR/src/skills/$skill" "$dest"
find "$dest" -type f -name '*.md' -print0 | xargs -0 perl -pi -e \
"s/(?<![A-Za-z0-9\/-])(?<!\Q$PREFIX\E)($NAMES_ALT)(?![A-Za-z0-9-])/$PREFIX\$1/g"
done <<< "$SKILLS"
echo "Synced: $(echo "$SKILLS" | sed "s/^/$PREFIX/" | tr '\n' ' ')"

node "$ROOT/scripts/check-skills.js" "$ROOT"
13 changes: 13 additions & 0 deletions skills.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
{
"repo": "https://github.com/mondaycom/skills.git",
"ref": "b41be7f7b84134d0b074968482c70fc9e8e53418",
"prefix": "monday-",
"skills": [
"onboard-to-monday",
"task-management",
"board-setup",
"project-status-report",
"docs-collaborator",
"forms-builder"
]
}
Loading
Loading