shareful-search

Original：🇺🇸 English

Translated

Helps users discover and apply shared coding solutions when they ask "has anyone solved this", "search for a fix", "find a workaround", or want proven patterns before debugging from scratch. Uses `npx shareful-ai search` to find relevant shares, compare options, and recommend the best match.

1installs

Sourceshareful-ai/skills

Added on2026-02-10

NPX Install

npx skill4agent add shareful-ai/skills shareful-search

SKILL.md Content

View Translation Comparison →

Shareful Search

This skill helps discover and apply existing coding solutions from shareful.ai.

When to Use This Skill

Use this skill when the user:

Asks "has anyone solved this" or "is there a known fix for X"
Wants to search for existing solutions before deep debugging
Has an error message and wants likely fixes quickly
Needs a workaround for a framework/library gotcha
Wants proven patterns from real examples

What is Shareful CLI Search?

npx shareful-ai search

queries shareful.ai for existing shared solutions.

Key commands:

```
npx shareful-ai search [query]
```
- Search by keywords

npx shareful-ai search [query] --type fix

- Filter by solution type

npx shareful-ai search [query] --tags "tag1,tag2"

- Filter by tags

npx shareful-ai search [query] --limit 10

- Return more results

npx shareful-ai confirm <owner/repo/slug>

- Report a share worked

npx shareful-ai confirm <owner/repo/slug> --failed

- Report it didn't work

Browse shares at: https://shareful.ai/

How to Help Users Find Shares

Step 1: Understand What They Need

When a user asks for help, identify:

The technology stack (framework, language, key libraries)
The specific issue (error string, symptom, or behavior)
The likely share type (
```
fix
```
,
```
workaround
```
,
```
pattern
```
,
```
reference
```
,
```
config
```
)

Step 2: Search for Shares

Run search with a focused query:

bash

npx shareful-ai search [query]

Examples:

User asks "how do I fix hydration mismatch?" ->

npx shareful-ai search nextjs hydration mismatch

User asks "known Prisma N+1 fix?" ->

npx shareful-ai search prisma n-plus-one --type fix

User asks "React stale closure issue" ->

npx shareful-ai search react stale closure --tags "react,hooks"

Step 3: Present Options to the User

When you find relevant shares, present:

Share title and solution type
Why it matches the user issue
Link to the share URL

Example response:

text

I found a likely match: "Fix Next.js hydration error with dynamic imports" [fix, verified].
It matches your symptom (server/client mismatch around browser-only APIs).

Share: https://shareful.ai/s/owner/repo/fix-nextjs-hydration-dynamic-imports

Step 4: Apply and Confirm

If the user wants to proceed:

Apply the fix in their codebase
Verify the original issue is resolved
If fixed, confirm the share worked:
bash
```
npx shareful-ai confirm owner/repo/slug
```
If it didn't work, report failure and try the next result:
bash
```
npx shareful-ai confirm owner/repo/slug --failed
```

Common Search Categories

Category	Example Queries
React/Next.js	hydration, server-components, suspense, ssr
Data/DB	prisma, postgres, query, migration, n-plus-one
TypeScript	generics, module-augmentation, satisfies, inference
Build/Deploy	docker, cache, ci, github-actions, vercel
Configuration	eslint, tsconfig, env-vars, runtime

Tips for Effective Searches

Use specific keywords:
```
nextjs hydration mismatch
```
is better than
```
nextjs error
```
Include error fragments: Copy a unique part of the error text
Try alternate terms:
```
n+1
```
,
```
n-plus-one
```
,
```
relation loading
```
Use filters: Narrow with
```
--type
```
and
```
--tags
```
when result sets are broad

When No Shares Are Found

If no relevant shares exist:

Acknowledge no match was found
Continue with direct debugging
Suggest creating a new share via
```
shareful-create
```