Index of every page on this site: llms.txt
All skills
makenotion avatar

/research-documentation

@016c74f official
Run it yourself

Researches questions across Notion sources and synthesizes cited briefs, comparisons, or reports. Use when answering requires discovering and reconciling workspace information, optionally with external research, and returning or saving the findings.

  • 27 files
  • 61.6 KB
  • Updated 2 weeks ago
  • GitHub
Use this Skill: https://skilld.dev/gh/makenotion/claude-code-notion-plugin/research-documentation

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencecitations.md

≈1.3k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Citation Styles

Basic Page Citation

For Notion sources in saved Notion content, use page mentions. For external sources or chat output, use ordinary Markdown links to the original source:

<mention-page url="https://notion.so/workspace/Page-Title-uuid">Page Title</mention-page>

The URL must be provided. The title is optional but improves readability:

<mention-page url="https://notion.so/workspace/Page-Title-uuid"/>

Inline Citations

Cite immediately after referenced information:

The Q4 revenue increased by 23% quarter-over-quarter (<mention-page url="...">Q4 Financial Report</mention-page>).

Multiple Sources

When information comes from multiple sources:

Customer satisfaction has improved across all metrics (<mention-page url="...">Q3 Survey Results</mention-page>, <mention-page url="...">Support Analysis</mention-page>).

Section-Level Citations

For longer sections derived from one source:

### Engineering Priorities

According to the <mention-page url="...">Engineering Roadmap 2025</mention-page>:

- Focus on API scalability
- Improve developer experience
- Migrate to microservices architecture

Sources Section

For longer reports, collect cited sources at the end. A short brief with clear inline citations does not need a duplicate list:

## Sources

- <mention-page url="...">Strategic Plan 2025</mention-page>
- <mention-page url="...">Market Analysis Report</mention-page>
- <mention-page url="...">Competitor Research: Q3</mention-page>
- <mention-page url="...">Customer Interview Notes</mention-page>

Group by category for long lists:

## Sources

### Primary Sources

- <mention-page url="...">Official Roadmap</mention-page>
- <mention-page url="...">Strategy Document</mention-page>

### Supporting Research

- <mention-page url="...">Market Trends</mention-page>
- <mention-page url="...">Customer Feedback</mention-page>

### Background Context

- <mention-page url="...">Historical Analysis</mention-page>

Quoting Content

When quoting directly from source:

The product team noted: "We need to prioritize mobile experience improvements" (<mention-page url="...">Product Meeting Notes</mention-page>).

For block quotes:

> We need to prioritize mobile experience improvements to meet our Q4 goals. This includes performance optimization and UI refresh.
>
> — <mention-page url="...">Product Meeting Notes - Oct 2025</mention-page>

Data Citations

When presenting data, cite the source:

| Metric  | Q3    | Q4    | Change |
| ------- | ----- | ----- | ------ |
| Revenue | $2.3M | $2.8M | +21.7% |
| Users   | 12.4K | 15.1K | +21.8% |

Source: <mention-page url="...">Financial Dashboard</mention-page>

Database Citations

When referencing database content:

Based on analysis of the <mention-database url="...">Projects Database</mention-database>, 67% of projects are on track.

User Citations

When attributing information to specific people:

<mention-user url="...">Sarah Chen</mention-user> noted in <mention-page url="...">Architecture Review</mention-page> that the microservices migration is ahead of schedule.

Citation Frequency

Over-citing (every sentence):

The revenue increased (<mention-page url="...">Report</mention-page>).
Costs decreased (<mention-page url="...">Report</mention-page>).
Margin improved (<mention-page url="...">Report</mention-page>).

Under-citing (no attribution):

The revenue increased, costs decreased, and margin improved.

Right balance (grouped citation):

The revenue increased, costs decreased, and margin improved (<mention-page url="...">Q4 Financial Report</mention-page>).

Outdated Information

Note when source information might be outdated:

The original API design (<mention-page url="...">API Spec v1</mention-page>, last updated January 2024) has been superseded by the new architecture in <mention-page url="...">API Spec v2</mention-page>.

Cross-References

Link to related research documents:

## Related Research

This research builds on previous findings:

- <mention-page url="...">Market Analysis - Q2 2025</mention-page>
- <mention-page url="...">Competitor Landscape Review</mention-page>

For implementation details, see:

- <mention-page url="...">Technical Implementation Guide</mention-page>

Citation Validation

Before finalizing research:

✓ Every key claim has a source citation ✓ All page mentions have valid URLs ✓ When included, the sources section includes all cited pages ✓ Outdated sources are noted as such ✓ Direct quotes are clearly marked ✓ Data sources are attributed

Citation Style Consistency

Choose one citation style and use throughout:

Inline style (lightweight):

Revenue grew 23% (Financial Report). Customer count increased 18% (Metrics Dashboard).

Formal style (full mentions):

Revenue grew 23% (<mention-page url="...">Q4 Financial Report</mention-page>). Customer count increased 18% (<mention-page url="...">Metrics Dashboard</mention-page>).

Recommend formal style for most research documentation as it provides clickable navigation.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 016c74f. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 2 weeks ago

README badge

README badge for makenotion/claude-code-notion-plugin/research-documentation