Agent skill

Memory Research

by basicmachines-co in basicmachines-co/basic-memory

Research an external subject using web search, synthesize findings into a structured Basic Memory entity.

AGPL-3.0Auto-check passedProductivity & Automation

Install Memory Research

skills CLI
$ npx skills add basicmachines-co/basic-memory --skill memory-research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install basicmachines-co/basic-memory memory-research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/memory-research .claude/skills/memory-research && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
memory-research
GitHub stars
4.1k
Used in
1 other repo
Token cost
~1.9k tokens
SKILL.md length
602 words
Files
1
Skills in repo
49
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Research an external subject using web search, synthesize findings into a structured Basic Memory entity.

  • Works in 6 steps: Web Research → Check Existing Knowledge → Evaluate and Summarize → …
  • Asked to research a company
  • SKILL.md covers Workflow and Guidelines
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Memory Research is an agent skill from basicmachines-co/basic-memory. Research an external subject using web search, synthesize findings into a structured Basic Memory entity. Use when asked to research a company, person, technology, or topic — or when a bare name or URL is provided that implies a research request.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Web search. The repository describes itself as: AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN. The licence is AGPL-3.0.

When your agent uses it

  • Asked to research a company
  • URL is provided that implies a research request

Example prompts

  • “/memory-research”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Web Research
  2. Check Existing Knowledge
  3. Evaluate and Summarize
  4. Propose Entity Creation
  5. Create the Entity
  6. Store Source Context

What it can do on your machine

Read from SKILL.md and the folder at commit 6982cfc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.parallel.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Memory Research loads about 1.9k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 602 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~66
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from basicmachines-co/basic-memory at commit 6982cfc, republished under its AGPL-3.0 licence (© basicmachines-co). 602 words, ~1,938 tokens.

Download SKILL.mdSave it as .claude/skills/memory-research/SKILL.md (or your agent's skills folder).
name
memory-research
description
Research an external subject using web search, synthesize findings into a structured Basic Memory entity. Use when asked to research a company, person, technology, or topic — or when a bare name or URL is provided that implies a research request.

Memory Research

Research an external subject, synthesize what you find, and create a structured Basic Memory entity — with the user's approval.

Workflow

Step 1: Web Research

Basic Memory does not include a web search tool. If this host already has one, use it. If it does not, the user can add any web search tool or MCP server, for example Parallel Search MCP. Search queries go to that provider, so keep private note content out of them. Still ask before saving a note.

Search for current information across multiple sources. Aim for 3-5 searches to build a well-rounded picture:

[subject name] site
[subject name] overview
[subject name] news [current year]
[subject name] [relevant domain keywords]

What to gather by entity type:

Entity TypeKey Information
OrganizationWhat they do, products/services, stage (startup/growth/public), funding, leadership, headquarters, employee count, notable partnerships or contracts
PersonCurrent role, organization, background, expertise, notable work, public presence
TechnologyWhat it does, who maintains it, maturity, ecosystem, alternatives, adoption
Topic/DomainDefinition, current state, key players, trends, relevance to user's context
Step 2: Check Existing Knowledge

Before proposing a new entity, search Basic Memory:

python
search_notes(query="Acme Corp")
search_notes(query="acme")

Try name variations — full name, abbreviation, acronym, domain name.

If the entity already exists:

  • Report what you found in Basic Memory alongside your web research
  • Offer to update the existing note with new information
  • Use edit_note to append new observations or update outdated ones

If the entity doesn't exist, proceed to evaluation.

Step 3: Evaluate and Summarize

Present your findings in a structured summary. Include all relevant information organized by section:

markdown
## [Subject Name]

**Type:** [Organization / Person / Technology / Topic]

**Summary:** [2-4 sentences: what this is, why it matters, key distinguishing facts]

**Key Details:**
- [Organized by what's relevant for the entity type]
- [Stage, funding, leadership for orgs]
- [Role, expertise, affiliations for people]
- [Maturity, ecosystem, alternatives for tech]

**Relevance:** [Why this matters to the user — connection to their work, domain, or interests.
If no obvious connection: "No specific connection identified."]

**Sources:**
- [URLs of key sources consulted]
Evaluation Guidelines

Use hedging language. Web research is a snapshot, not ground truth:

  • "Appears to be", "Based on public information", "Estimated"
  • "As of [date]", "According to [source]"
  • Never state funding amounts, employee counts, or revenue as exact unless citing a primary source

Don't fabricate. If information isn't available, say so:

  • "Leadership information not publicly available"
  • "Funding details not disclosed"

Let the user define relevance. Don't impose a fixed evaluation framework. Instead, highlight facts and let the user draw conclusions. If the user has a specific evaluation rubric (strategic fit, buy/partner/compete, etc.), they'll tell you — apply it when asked.

Step 4: Propose Entity Creation

After presenting the summary, ask for approval:

Create Basic Memory entity for [Subject]?
  Location: [suggested-folder]/[entity-name].md
  Type: [entity type]

  [yes / no / modify]

If the user provided context with their request ("saw them at the conference"), include that context in the proposed entity.

Show full SKILL.md (231 more words)Show less
Step 5: Create the Entity

After approval, create a structured note. Adapt the template to the entity type:

Organization
python
write_note(
  title="Acme Corp",
  directory="organizations",
  note_type="organization",
  tags=["organization", "relevant-tags"],
  content="""# Acme Corp

## Overview
[2-3 sentence description from research]

## Products & Services
- [Key offerings discovered in research]

## Background
**Stage:** [Startup / Growth / Public]
**Headquarters:** [Location]
**Employees:** [Estimate, hedged]
**Leadership:** [Key people if found]
**Founded:** [Year if found]

## Observations
- [relevance] Why this entity matters in user's context
- [source] Researched on YYYY-MM-DD
- [additional observations from research findings]

## Relations
- [Link to related entities already in the knowledge graph]"""
)
Person
python
write_note(
  title="Jane Smith",
  directory="people",
  note_type="person",
  tags=["person", "relevant-tags"],
  content="""# Jane Smith

## Overview
[Current role and affiliation. Brief background.]

## Background
**Role:** [Title at Organization]
**Expertise:** [Key domains]
**Notable:** [Publications, talks, projects if found]

## Observations
- [role] Title at Organization
- [expertise] Key technical or domain expertise
- [source] Researched on YYYY-MM-DD

## Relations
- works_at [[Organization]]"""
)
Technology
python
write_note(
  title="Technology Name",
  directory="concepts",
  note_type="concept",
  tags=["concept", "technology", "relevant-tags"],
  content="""# Technology Name

## Overview
[What it is and what problem it solves]

## Key Details
**Maintained by:** [Organization or community]
**Maturity:** [Experimental / Stable / Mature]
**License:** [If applicable]
**Alternatives:** [Comparable tools or approaches]

## Observations
- [definition] What this technology does in one sentence
- [maturity] Current state and adoption level
- [source] Researched on YYYY-MM-DD

## Relations
- [Link to related concepts, tools, or projects in the knowledge graph]"""
)

Adapt these templates freely. The key elements are: note_type/tags parameters, an overview, structured details, observations with categories, and relations.

Step 6: Store Source Context

If the user provided context with their request, capture it in the entity:

python
# User said: "Acme Corp — saw their demo at the conference last week"
edit_note(
  identifier="Acme Corp",
  operation="insert_after_section",
  section="Observations",
  content="- [context] Saw their demo at conference, week of 2026-02-17"
)

This context is often the most valuable part — it's the user's relationship to the entity, which web research can't provide.

Guidelines

  • Always web search. Don't rely on training data alone. Research should reflect current, verifiable information.
  • Search Basic Memory first. Check for existing entities before creating new ones. Update rather than duplicate.
  • Hedge uncertain information. Use qualifiers for estimates, unverified claims, and inferred details.
  • Store source URLs. Include the URLs you consulted, either in observations or a Sources section. This enables the user to verify and dig deeper.
  • Get approval before creating. Present your findings and let the user decide whether to create the entity and what to include.
  • Capture user context. If the user told you why they're researching (met at a conference, evaluating as a vendor, etc.), that context belongs in the entity.
  • Don't over-research. 3-5 web searches is usually enough. The goal is a useful knowledge graph entry, not an exhaustive report.
  • Link to existing knowledge. Relate the new entity to things already in the knowledge graph. Connections compound value.

© basicmachines-co, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/memory-research of basicmachines-co/basic-memory.

Open the folder on GitHubat commit 6982cfc

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in basicmachines-co/basic-memory, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Memory Research next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Memory Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Memory Research this skillbasicmachines-co/basic-memory4.1k1 repos~1.9kAutomated safety check: PassAGPL-3.0
Brave Searchbadlogic/pi-skills2.6k6 repos~592Automated safety check: PassMIT
Enterprise AI Scenario MapMetaInFLow/Enterprise-ai-scenario-map-skill632—~1.8kAutomated safety check: PassMIT
Web Searchjjyaoao/HelloAgents3.2k1 repos~5.6kAutomated safety check: PassMIT
Ddg SearchTheSyart/claude-agent-examples4041 repos~493Automated safety check: PassNone
Local Web SearchuluckyXH/OpenMOSS1.3k—~392Automated safety check: NotesMIT

Similar skills

  • Brave Search

    badlogic/pi-skills

    Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills.

    2.6k GitHub starsUsed in 6 repos~592 tokens
    Productivity & AutomationAuto-check passed
  • Enterprise AI Scenario Map

    MetaInFLow/Enterprise-ai-scenario-map-skill

    企业AI场景地图生成报告工具。通过 web-search 深度调研企业信息,按照V2.1标准模板生成结构化AI应用场景地图报告,包含企业画像、业务诊断、行业实践、AI场景全量表、实施路径等完整内容。

    632 GitHub stars~1.8k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check passed
  • Web Search

    jjyaoao/HelloAgents

    Implement web search capabilities using the z-ai-web-dev-sdk.

    3.2k GitHub starsUsed in 1 repo~5.6k tokens
    Productivity & AutomationAuto-check passed
  • Ddg Search

    TheSyart/claude-agent-examples

    Web search without an API key using DuckDuckGo Lite via webfetch.

    404 GitHub starsUsed in 1 repo~493 tokens
    Productivity & AutomationAuto-check passed
  • Local Web Search

    uluckyXH/OpenMOSS

    A skill your agent uses when the user asks for web search that should run via the local-160 Responses API with websearch tool (base URL like https://proxy.example.com, model gpt-5.2-codex(xhigh)).

    1.3k GitHub stars~392 tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check: notes
  • Web Search

    EXboys/skilllite

    Web search and content extraction with Tavily and Exa via inference.sh CLI.

    170 GitHub starsUsed in 3 repos~1k tokens
    Productivity & AutomationAuto-check passed

More from basicmachines-co/basic-memory

All 49 skills in this repo
  • cmux Settings Editor

    basicmachines-co/basic-memory

    Views, sets, unsets and validates cmux settings in ~/.config/cmux/cmux.json with a helper script that checks keys against the schema.

    4.1k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • cmux Window and Pane Control

    basicmachines-co/basic-memory

    End-user control of cmux topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs…

    4.1k GitHub starsUsed in 2 repos~842 tokens
    Auto-check passed
  • Cmux Markdown Viewer Panel

    basicmachines-co/basic-memory

    Opens markdown files in a formatted cmux panel beside the terminal that re-renders on every change, handy for plans and task lists.

    4.1k GitHub starsUsed in 2 repos~527 tokens
    Auto-check passed
  • cmux Workspace Scoping

    basicmachines-co/basic-memory

    Keeps agent actions scoped to the cmux workspace and terminal that invoked it, and lays out pane and surface commands that avoid disrupting the user's own focus.

    4.1k GitHub starsUsed in 2 repos~1.7k tokens
    Auto-check passed
  • Basic Memory Repo Images

    basicmachines-co/basic-memory

    Produces PR, changelog and two-week retro images for the Basic Memory repository from evidence in PR bodies, saved to fixed paths under docs/assets/infographics.

    4.1k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Logfire Instrumentation

    basicmachines-co/basic-memory

    Adds Pydantic Logfire tracing, logging and metrics to Python, JavaScript or TypeScript and Rust projects, with the correct setup order and library extras.

    4.1k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Questions about Memory Research

What does Memory Research do?

Research an external subject using web search, synthesize findings into a structured Basic Memory entity. Memory Research is an agent skill from basicmachines-co/basic-memory. Research an external subject using web search, synthesize findings into a structured Basic Memory entity.

When should I use Memory Research?

Memory Research fits situations like: asked to research a company; URL is provided that implies a research request.

How do I install Memory Research in Claude Code?

Run `npx skills add basicmachines-co/basic-memory --skill memory-research -a claude-code`. Or copy the skill folder (skills/memory-research in basicmachines-co/basic-memory) into .claude/skills/memory-research in your project. Claude Code loads it when a task matches its description.

How do I install Memory Research in Codex?

Run `npx skills add basicmachines-co/basic-memory --skill memory-research -a codex`. Or copy the skill folder (skills/memory-research in basicmachines-co/basic-memory) into .agents/skills/memory-research in your project. Codex loads it when a task matches its description.

Can I use Memory Research in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add basicmachines-co/basic-memory --skill memory-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/memory-research, .gemini/skills/memory-research, .github/skills/memory-research and .opencode/skills/memory-research in your project.

What does Memory Research need to run?

SKILL.md names no scripts, command-line tools or credentials: Memory Research is instructions for the agent only. Our summary lists: Python 3.

Does Memory Research access the network?

SKILL.md names 1 domain. As links in the text: docs.parallel.ai. This is read from the text; nothing was executed.

Is Memory Research safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Memory Research use?

Memory Research is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Memory Research use?

About 1.9k tokens (SKILL.md is roughly 7.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Memory Research?

Skills that share tags, products or a category with Memory Research: Brave Search (badlogic/pi-skills, 2.6k stars), Enterprise AI Scenario Map (MetaInFLow/Enterprise-ai-scenario-map-skill, 632 stars), Web Search (jjyaoao/HelloAgents, 3.2k stars) and Ddg Search (TheSyart/claude-agent-examples, 404 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Memory Research?

basicmachines-co (a GitHub organization) maintains it in basicmachines-co/basic-memory, which has 4,107 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 7, 2026.

Source: basicmachines-co/basic-memory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.