# Search And Fork

> Use this skill when the user asks to search for and fork an open source repository, "find me an open source project", "search and fork", "search-and-fork", "find a similar project on Gitee", or "fork a repository". Requires Gitee MCP Server to be configured.

- **Type:** Skill
- **Install:** `agentstack add skill-oschina-gitee-agent-skills-search-and-fork`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [oschina](https://agentstack.voostack.com/s/oschina)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [oschina](https://github.com/oschina)
- **Source:** https://github.com/oschina/gitee-agent-skills/tree/main/skills/search-and-fork

## Install

```sh
agentstack add skill-oschina-gitee-agent-skills-search-and-fork
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

> **Note**: If you have `mcporter` installed locally, you should use `mcporter` to invoke the MCP tool instead of directly calling the MCP tool. The `mcporter` CLI provides a more convenient interface and better error handling.

# Search and Fork via Gitee MCP

Search for open source repositories on Gitee that match the user's needs, compare candidates, and fork the chosen one to the user's account.

## Prerequisites

- Gitee MCP Server configured (tools: `search_open_source_repositories`, `fork_repository`, `get_user_info`, `get_file_content`)
- User must provide: search keywords or a description of what they need

## Steps

### Step 1: Clarify Search Requirements

Confirm with the user:
- Language preference (Go / Java / Python / JavaScript, etc.)
- Use case (web framework / database ORM / CLI tool / UI component library, etc.)
- Activity requirements (e.g., must have recent commits)
- Other preferences (license type, documentation language, etc.)

### Step 2: Search Repositories

Use `search_open_source_repositories` to search:
- Try multiple keyword combinations to cover different phrasings
- Run 2–3 searches if necessary (e.g., both Chinese and English keywords)

### Step 3: Filter and Compare

Evaluate the search results based on:

**Activity indicators**
- Star count (interest/popularity)
- Fork count (how widely it's being used)
- Last updated date (whether it's still maintained)
- Issue / PR count and response speed

**Quality indicators**
- Complete README documentation
- Test code present
- CI/CD configuration
- License suitable for the use case (MIT / Apache preferred over GPL)

**Relevance**
- Does the functionality match the requirements?
- Does the tech stack fit?
- Is there good documentation or community support?

### Step 4: Present Candidate List

```
## Search Results: [keywords]

Top candidates ranked by overall score:

### Recommendation #1: [repo name]
- **Repo**: [owner/repo]
- **Description**: [repo summary]
- **Stars / Forks**: ⭐ N / 🍴 N
- **Language**: [language]
- **Last updated**: [date]
- **License**: [license]
- **Why recommended**: [1–2 sentences]

### Recommendation #2: [repo name]
[same format]

### Recommendation #3: [repo name]
[same format]

---

**Suggested pick**: Recommendation #1, because [reason]
```

### Step 5: Explore the Selected Repository (Optional)

After the user makes a selection but before forking, you can use `get_file_content` to fetch more details to help the user confirm their choice:

**Step 5.1: Get directory tree**
```
get_file_content(owner="[owner]", repo="[repo]", path="/")
```

**Step 5.2: Get README content (if available)**

From the directory tree, check if there's a README file (e.g., `README.md`, `README_CN.md`, `README.en.md`). Then fetch it:

```
get_file_content(owner="[owner]", repo="[repo]", path="README.md")
```

Present the key findings to help the user make an informed decision:
- Project structure overview
- Main functionality from README
- Tech stack and dependencies
- Whether it's actively maintained

### Step 6: Fork the Selected Repository

After the user makes a selection, use `fork_repository` to fork it:
- `owner`: owner of the repository to fork
- `repo`: repository name
- Optional: specify an organization to fork into (defaults to the user's personal account)

After a successful fork, output the forked repository URL and suggest next steps:

```
Fork successful!

**Your repository**: https://gitee.com/[your-username]/[repo-name]

**Suggested next steps:**
1. `git clone` it locally
2. Read the README to learn how to contribute
3. Browse the Issues to find something to work on

Would you like me to explore this repository for you? (use the repo-explorer skill)
```

## Notes

- Search results may include archived or unmaintained repositories — filter these out
- Forking creates a copy under the user's Gitee account without affecting the original repository
- Fork is the standard approach for contributing; if the user only wants to reference the code, a plain clone is sufficient
- For commercial use, pay close attention to the license (GPL is copyleft; MIT / Apache are more permissive)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [oschina](https://github.com/oschina)
- **Source:** [oschina/gitee-agent-skills](https://github.com/oschina/gitee-agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-oschina-gitee-agent-skills-search-and-fork
- Seller: https://agentstack.voostack.com/s/oschina
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.