← Back to Skills Marketplace
fental

notion-enhanced-markdown-integration

by Fental Huang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
83
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install notion-enhanced-markdown
Description
Notion API for creating and managing pages, databases, blocks and enhanced markdown.
Usage Guidance
This skill appears to do what it says (curl calls to api.notion.com to read/write pages and markdown), but the SKILL.md and registry metadata disagree about how the Notion key is provided: the registry lists NOTION_API_KEY, while the instructions tell you to store the key in ~/.config/notion/api_key and use NOTION_KEY. Before installing, ask the author to clarify/fix: (1) which environment variable name the platform should provide (NOTION_API_KEY vs NOTION_KEY), (2) whether the skill will read ~/.config/notion/api_key — if so, that path should be declared and you should be aware of file permissions (avoid world-readable files), and (3) confirm the skill only contacts api.notion.com. If you proceed, grant the integration the minimum Notion scopes needed (read-only vs insert_content) and avoid storing long-lived keys in unsecured files. If you want higher assurance, request the full (non-truncated) SKILL.md and an explanation of secret-handling behavior so the inconsistencies can be resolved.
Capability Analysis
Type: OpenClaw Skill Name: notion-enhanced-markdown Version: 1.0.0 The skill bundle describes a non-existent 'Markdown API' and a future-dated Notion API version (2026-03-11), which will cause the agent to fail when attempting to interact with the real Notion service. Additionally, the documentation in SKILL.md provides curl examples that are vulnerable to shell command injection if the agent populates placeholders (e.g., {page_id} or {data_source_id}) with unsanitized user input. While the behavior is highly unusual and non-functional, there is no clear evidence of intentional data exfiltration or malicious backdoors.
Capability Assessment
Purpose & Capability
The name/description and the SKILL.md consistently implement Notion API operations (pages, databases/data_sources, blocks, markdown). Requiring a Notion API credential is proportionate. However, the registry metadata declares NOTION_API_KEY as the required env var, while the SKILL.md examples use a file (~/.config/notion/api_key) and an environment variable named NOTION_KEY — an inconsistency between claimed and actual usage.
Instruction Scope
The instructions tell the agent/operator to read the API key from ~/.config/notion/api_key (via cat) and set NOTION_KEY, but the skill's declared requirements do not list that config path. The SKILL.md otherwise confines actions to api.notion.com endpoints and curl calls (expected), but the explicit filesystem access to a user key file is not declared and expands the surface area.
Install Mechanism
This is an instruction-only skill with no install spec and no code files. That minimizes install-time risk — nothing is downloaded or written by an installer.
Credentials
Only a single credential (Notion API key) is requested, which is appropriate. But there's inconsistency: registry expects NOTION_API_KEY as primaryEnv, while SKILL.md uses a file and an env var named NOTION_KEY. The skill does not declare the ~/.config/notion/api_key path even though the instructions read it. That mismatch weakens the stated proportionality and could lead to unexpected secret handling.
Persistence & Privilege
always is false and the skill does not request system-wide modifications or persistent presence. Autonomous invocation is allowed (platform default) but not combined with other high-risk flags here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install notion-enhanced-markdown
  3. After installation, invoke the skill by name or use /notion-enhanced-markdown
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Notion skill 1.0.0 adds support for enhanced Markdown read/write API and updates to the latest Notion API. - Updated to Notion API version 2026-03-11, with new endpoints and terminology - Added Markdown API sections for creating, reading, and updating pages as plain Markdown - Detailed support for Markdown-compatible block types, syntax, and limitations - Expanded documentation for search/replace, partial updates, and content replacement in Markdown - Updated environment variable and setup instructions - Clarified differences and usage of database_id vs. data_source_id
Metadata
Slug notion-enhanced-markdown
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is notion-enhanced-markdown-integration?

Notion API for creating and managing pages, databases, blocks and enhanced markdown. It is an AI Agent Skill for Claude Code / OpenClaw, with 83 downloads so far.

How do I install notion-enhanced-markdown-integration?

Run "/install notion-enhanced-markdown" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is notion-enhanced-markdown-integration free?

Yes, notion-enhanced-markdown-integration is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does notion-enhanced-markdown-integration support?

notion-enhanced-markdown-integration is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created notion-enhanced-markdown-integration?

It is built and maintained by Fental Huang (@fental); the current version is v1.0.0.

💬 Comments