Skip to content

Commit 0d259fc

Browse files
TMHSDigitalTMHSDigital
committed
feat: ship Monday Developer Tools v0.1.0
Add Cursor plugin with 21 skills and 8 rules for Monday.com workflows, pytest structure tests, GitHub Actions (validate, CodeQL, Pages, stale, release-drafter), and GitHub Pages docs. Skills cover boards, items, workspaces, GraphQL, dashboards, sprints, forms, webhooks, and MCP escape-hatch patterns. No bundled MCP server; users install the official Monday.com plugin from the Cursor marketplace. Made-with: Cursor
1 parent 51ab595 commit 0d259fc

File tree

64 files changed

+4599
-1
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

64 files changed

+4599
-1
lines changed

‎.cursor-plugin/plugin.json‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
{
2+
"name": "monday-cursor-plugin",
3+
"displayName": "Monday Developer Tools",
4+
"version": "0.1.0",
5+
"description": "21 skills, 8 rules for Monday.com workflows in Cursor -- boards, items, sprints, docs, dashboards, and the full GraphQL API.",
6+
"author": {
7+
"name": "TMHSDigital",
8+
"url": "https://github.com/TMHSDigital"
9+
},
10+
"homepage": "https://tmhsdigital.github.io/Monday-Cursor-Plugin/",
11+
"repository": "https://github.com/TMHSDigital/Monday-Cursor-Plugin",
12+
"license": "CC-BY-NC-ND-4.0",
13+
"keywords": [
14+
"monday",
15+
"project-management",
16+
"boards",
17+
"graphql",
18+
"sprints",
19+
"work-os",
20+
"dashboards",
21+
"items",
22+
"automations",
23+
"cursor-plugin"
24+
],
25+
"category": "developer-tools",
26+
"tags": [
27+
"monday.com",
28+
"work-os",
29+
"boards",
30+
"items",
31+
"dashboards",
32+
"graphql",
33+
"project-management"
34+
],
35+
"logo": "assets/logo.png",
36+
"skills": "./skills/",
37+
"rules": "./rules/"
38+
}

‎.cursorrules‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# Monday Cursor Plugin -- Contributor Conventions
2+
3+
## Plugin Structure
4+
5+
- Skills live in `skills/<skill-name>/SKILL.md` (kebab-case directory names)
6+
- Rules live in `rules/<rule-name>.mdc` (kebab-case filenames)
7+
- All skill and rule names start with `monday-`
8+
- Plugin manifest: `.cursor-plugin/plugin.json`
9+
- Logo: `assets/logo.png`
10+
11+
## Skill Format
12+
13+
Every SKILL.md must have:
14+
1. YAML frontmatter with `name` (matching directory name) and `description` (>= 20 chars)
15+
2. Sections in this order:
16+
- `# <Title>`
17+
- `## Trigger`
18+
- `## Required Inputs`
19+
- `## Workflow`
20+
- `## Key References`
21+
- `## Example Interaction`
22+
- `## MCP Usage`
23+
- `## Common Pitfalls`
24+
- `## See Also` (relative links to other skills: `../other-skill/SKILL.md`)
25+
26+
## Rule Format
27+
28+
Every .mdc rule must have:
29+
1. YAML frontmatter with `description` and `alwaysApply` (boolean)
30+
2. If `alwaysApply: false`, must include `globs` array
31+
3. Body sections: Patterns to Flag, What to Do, Exceptions
32+
33+
## MCP Tool Naming
34+
35+
- Reference Monday MCP tools by their exact names (e.g., `create_board`, `get_board_info`)
36+
- For operations not covered by dedicated MCP tools, provide `all_monday_api` GraphQL recipes
37+
- Document which MCP tools each skill uses in the MCP Usage table
38+
39+
## Content Rules
40+
41+
- No em dashes; use double hyphens `--` instead
42+
- No hardcoded API tokens or secrets in any file
43+
- Column value JSON examples must use the column ID as the outer key, not the type name
44+
- GraphQL examples should use variables for dynamic values
45+
46+
## Release Checklist
47+
48+
When releasing a new version:
49+
1. Bump version in `.cursor-plugin/plugin.json`
50+
2. Update skill/rule counts in `plugin.json` description
51+
3. Update CHANGELOG.md with Added/Changed/Fixed sections
52+
4. Update README.md counts and tables
53+
5. Update CLAUDE.md tables
54+
6. Update ROADMAP.md status
55+
7. Update `docs/index.html` stats
56+
8. Run `pytest tests/ -v` and verify all pass
57+
9. Tag the release: `git tag v<version>`
58+
10. Create GitHub release with changelog

‎.env.example‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
# Monday.com API Token
2+
# Get yours at: https://monday.com → Profile → Admin → API
3+
# Required for most MCP tools (boards, items, updates, etc.)
4+
MONDAY_API_TOKEN=your_api_token_here

‎.github/CODEOWNERS‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
* @TMHSDigital

‎.github/FUNDING.yml‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
github: [TMHSDigital]

‎.github/ISSUE_TEMPLATE/bug_report.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
name: Bug Report
3+
about: Report a skill or rule that isn't working as expected
4+
title: "[Bug] "
5+
labels: bug
6+
assignees: ''
7+
---
8+
9+
**Component affected**
10+
Which component is involved?
11+
- [ ] Skill (specify: e.g., `monday-board-management`)
12+
- [ ] Rule (specify: e.g., `monday-api-token-safety.mdc`)
13+
- [ ] Plugin manifest (`plugin.json`)
14+
- [ ] Documentation
15+
- [ ] GitHub Pages
16+
17+
**Describe the bug**
18+
A clear description of what went wrong.
19+
20+
**Steps to reproduce**
21+
1. Open Cursor and ask: "..."
22+
2. Observe that ...
23+
24+
**Expected behavior**
25+
What should have happened instead.
26+
27+
**Actual behavior**
28+
What actually happened (paste relevant Cursor output if possible).
29+
30+
**Environment**
31+
- OS: [e.g., Windows 11, macOS 15, Ubuntu 24.04]
32+
- Cursor version: [e.g., 0.48]
33+
- Plugin version: [e.g., 0.2.0]
34+
- Monday MCP server installed: [yes / no]
35+
36+
**Additional context**
37+
Any other relevant details, screenshots, or error messages.

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: Discussions
4+
url: https://github.com/TMHSDigital/Monday-Cursor-Plugin/discussions
5+
about: Ask questions and share ideas

‎.github/ISSUE_TEMPLATE/feature_request.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
name: Feature Request
3+
about: Suggest a new skill, rule, or improvement
4+
title: "[Feature] "
5+
labels: enhancement
6+
assignees: ''
7+
---
8+
9+
**Is this a new skill, a new rule, or an improvement to an existing one?**
10+
- [ ] New skill
11+
- [ ] New rule
12+
- [ ] Improvement
13+
- [ ] Documentation
14+
- [ ] Other
15+
16+
**Describe the feature**
17+
A clear description of what you'd like added or changed.
18+
19+
**Use case**
20+
When would a Monday.com user need this? What problem does it solve?
21+
22+
**Monday.com APIs**
23+
Link any relevant Monday.com API documentation, GraphQL types, or endpoints.
24+
25+
**Additional context**
26+
Any examples, mockups, or related skills/rules that this connects to.

‎.github/PULL_REQUEST_TEMPLATE.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
## What does this PR do?
2+
3+
<!-- Brief description of the change -->
4+
5+
## Type of change
6+
7+
- [ ] New skill
8+
- [ ] New rule
9+
- [ ] Skill/rule improvement
10+
- [ ] Documentation update
11+
- [ ] Bug fix
12+
- [ ] Other
13+
14+
## Checklist
15+
16+
- [ ] YAML frontmatter is valid (skills: `name` + `description`; rules: `description` + `alwaysApply`)
17+
- [ ] Tested locally (plugin loads in Cursor, tests pass)
18+
- [ ] `pytest tests/ -v` passes
19+
- [ ] Updated CHANGELOG.md (if user-facing change)
20+
- [ ] No hardcoded credentials or secrets
21+
- [ ] No em dashes used

‎.github/dependabot.yml‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
version: 2
2+
updates:
3+
- package-ecosystem: pip
4+
directory: /
5+
schedule:
6+
interval: monthly
7+
8+
- package-ecosystem: github-actions
9+
directory: /
10+
schedule:
11+
interval: weekly
12+
day: monday

0 commit comments

Comments
 (0)