Skillzwave Logo
Skillzwave

notion-uploader-downloader

2 forks
87
B

Bidirectional sync between Markdown and Notion. Upload .md files with images to Notion pages/databases, append to existing pages, or download Notion content back to markdown. Supports rich formatting, tables, code blocks, GitHub-flavored markdown, and recursive page hierarchy downloads with YAML frontmatter for round-trip sync.

#User Goal#Notion#intent#tokens#NOTION TOKEN#NOTION PARENT#route#CONFIGURATION Intent

Third-Party Agent Skill: Review the code before installing. Agent skills execute in your AI assistant's environment and can access your files. Learn more about security

Installation for Agentic Skill

View all platforms →
skilz install SpillwaveSolutions/notion_uploader_downloader/notion-uploader-downloader
skilz install SpillwaveSolutions/notion_uploader_downloader/notion-uploader-downloader --agent opencode
skilz install SpillwaveSolutions/notion_uploader_downloader/notion-uploader-downloader --agent codex
skilz install SpillwaveSolutions/notion_uploader_downloader/notion-uploader-downloader --agent gemini

First time? Install Skilz: pip install skilz

Works with 14 AI coding assistants

Cursor, Aider, Copilot, Windsurf, Qwen, Kimi, and more...

View All Agents
Download Agent Skill ZIP

Extract and copy to ~/.claude/skills/ then restart Claude Desktop

1. Clone the repository:
git clone https://github.com/SpillwaveSolutions/notion_uploader_downloader
2. Copy the agent skill directory:
cp -r notion_uploader_downloader ~/.claude/skills/
View on GitHub

Need detailed installation help? Check our platform-specific guides:

Claude Desktop Guide Claude Code Guide Troubleshooting

Related Agentic Skills

markdown

by RedondoK

Transform AI markdown generation to be 100% markdownlint-compliant. Use this skill whenever generating messages containing markdown, generating or ...

88
markdown
Marketplace

markdown-quality

by racurry

Interpretive guidance for applying markdownlint rules using our opinionated configuration. Use when creating or editing markdown files, configuring...

82
markdown
Marketplace

markdown-linter-fixer

by s2005

Systematically fix linting issues in markdown files using markdownlint-cli2. This skill should be used when needing to scan, diagnose, and fix mark...

78
markdown
Marketplace

markdown-quality

by bostonaholic

Use when creating or editing any markdown file (.md) - ensures consistent formatting and zero linting violations through mandatory validation

75
markdown
Marketplace

Agentic Skill Details

Owner
SpillwaveSolutions (GitHub)
Repository
notion_uploader_downloader
Forks
2
Type
Technical
Meta-Domain
productivity
Primary Domain
markdown
Market Score
87
Agentic Skill Grades →

Agent Skill Grade

B
Score: 87/100 Click to see breakdown

Score Breakdown

Spec Compliance
13/15
PDA Architecture
28/30
Ease of Use
24/25
Writing Style
8/10
Utility
18/20
Modifiers: -4

Areas to Improve

  • Description needs trigger phrases
  • Second-person voice in guides
  • Missing TOC in longer guides

Recommendations

  • Add trigger phrases to description for discoverability
  • Add table of contents for files over 100 lines

Graded: 2026-01-19

Developer Feedback

I took a look at your notion-uploader-downloader skill and wanted to share some thoughts.

Links:

The TL;DR

You're at 87/100, solidly in B territory. This is based on Anthropic's Claude Skills best practices. Your strongest area is Ease of Use (24/25) — the metadata, discoverability, and workflow clarity are really well done. The weakest spot is Spec Compliance (13/15), mostly because the description is missing trigger phrases that help the classifier understand when to invoke your skill.

What's Working Well

  • Progressive Disclosure Architecture is tight — You've got a clean 3-tier structure with an orchestrator routing to on-demand guides and references. Token economy is excellent (9/10) with explicit counts for each tier.
  • Discoverability is chef's kiss — Your decision tree in the trigger terms section is super clear with explicit keywords like "upload to Notion", "download from Notion", "recursive download". This makes it obvious when to use the skill.
  • Your metadata frontmatter is complete — Name, version, allowed-tools, tier budgets, requirements — all there. This directly enables the ease-of-use score.
  • Command examples everywhere — You've got input/output pairs for all workflows, plus the .env.notion template. That's the kind of friction-reduction that matters.

The Big One: Missing Trigger Phrases

Your description in SKILL.md is missing actual trigger phrases. Right now it's:

description: Bidirectional sync between Markdown and Notion. Upload .md files with images to Notion pages/databases...

This costs you 2 points on spec compliance. Rewrite it to include explicit triggers like:

description: Performs bidirectional Markdown-Notion synchronization. Use when...

AI-Detected Topics

Extracted using NLP analysis

User Goal Notion intent tokens NOTION TOKEN NOTION PARENT route CONFIGURATION Intent DOWNLOAD Intent tokens Validation

Browse Category

More productivity Agentic Skills

Report Security Issue

Found a security vulnerability in this agent skill?