Notion Research & Documentation
Turn multiple Notion sources into cited briefs and structured reports.
The workflow requires searching, fetching, and creating or updating Notion pages, and it discloses the MCP and OAuth data path. However, it only clearly requests confirmation of research scope; per-write confirmation for publishing, task creation, or updates is incomplete, and sensitive-data handling, least privilege, rollback, and recovery are unspecified, so points are deducted.
The main workflow is reasonably consistent and includes a response to an unconnected Notion MCP. However, referenced files are not present in the supplied material, tool parameters and template reproduction are incomplete, and diagnostics or recovery for malformed input, conflicting sources, permission failures, and write failures are thin. Static calibration limits this score to 10 or below.
The audience, Notion multi-source research use case, report types, and scenarios are fairly clear. Non-fit boundaries, precise trigger conditions, Chinese-language output support, and mainland-China network reachability are not established; the core capability depends entirely on Notion MCP, so points are deducted.
The skill provides a quick start, staged workflow, examples, and evaluation guidance with useful information architecture. However, referenced materials are missing, and versioning, changelog, license, maintenance ownership, and update path are not clear; the supplied metadata also says the individual skill license is unknown, so points are deducted.
The claimed outputs—structured briefs, comparisons, reports, and citations—are clear, and the examples show directly usable document structures. Yet example correctness and tool execution are not statically verified, while database properties, templates, and citation formatting may require manual correction. Static calibration limits this score to 7 or below.
Evaluation scenarios, success criteria, and examples provide limited auditable evidence. There is no real CI, committed execution result, or independent corroboration; the evaluation files mostly specify expected behavior rather than verified outcomes. Static calibration limits this score to 5 or below.
- Core functionality depends on a remote Notion MCP; the supplied material does not establish reliable reachability from mainland-China networks.
- The skill can create and update pages and may create tasks; explicit per-action confirmation, permission scoping, sensitive-data handling, and rollback should be added or verified before use.
- The reference files cited by SKILL.md are not included in the supplied material; verify that those files, tool interfaces, and templates actually exist after installation.
- External research, pricing, market, and travel claims in the examples lack verifiable sources and should not be treated as evidence that the skill performs external fact checking.
What it does & when to use it
This skill researches across multiple Notion sources and turns the findings into structured documentation. It searches for relevant pages, fetches their contents, and records key facts, citations, and source links. It supports quick briefs, summaries, comparisons, and comprehensive reports. The resulting document can be created in Notion and updated as new information arrives.
Searches Notion for targeted sources, fetches relevant pages, captures facts, metrics, claims, constraints, and dates, tracks source URLs or IDs, selects an output format and matching template, creates a Notion page with inline citations and a references section, and updates pages with new findings.
- A team member needs project background consolidated from several Notion pages.
- An analyst needs scattered internal material synthesized into a research brief.
- A product or operations lead needs an option comparison published in Notion with source citations.
- A team needs to maintain an evolving research document containing highlights, risks, and open questions.
Pros & cons
- Defines an end-to-end workflow from source discovery through Notion publication.
- Explicitly preserves source links, inline citations, and a references section.
- Supports quick briefs, summaries, comparisons, and comprehensive reports.
- Supports ongoing maintenance through Notion page updates.
- Requires Notion MCP; the source instructs the user to configure it and complete OAuth if calls fail.
- The skill documents Notion research and documentation, but does not establish support for external websites, databases, or other knowledge bases.
- The supplied source includes no test suite, platform validation record, or individual LICENSE.txt contents.
- The parent openai/skills repository is marked deprecated in its README.
How to install
The skill is located at skills/.curated/notion-research-documentation/. The README says curated skills can be installed in Codex with $skill-installer notion-research-documentation; restart Codex after installation. The source does not document the exact destination path beyond the installer behavior.
How to use
A suitable trigger could be: “Research the Notion pages about project X, produce a cited comparison report, and publish it to Notion.” The workflow searches Notion first, then fetches pages; when multiple results appear, it requires scope confirmation. The referenced reference/ directory contains the detailed format and template guidance.