{
  "markdown": "# Valency Skills — Research Corpus Workflows for Gemini CLI\n\nA Gemini CLI extension that exposes seven skills for searching, profiling, and\nanalyzing millions of research papers (arXiv, PubMed, bioRxiv, medRxiv) via the\nValency MCP server. Each skill is a prescribed chain of tool calls — not a\nsingle search — so questions like \"what should David Hogg be reading next?\" or\n\"who should he be talking to that he isn't already?\" produce a structured,\nmulti-step answer instead of a raw search dump.\n\nThis is a port of the [Claude Code Valency plugin](https://github.com/valencyio/valency-plugin)\nto Gemini CLI's extension format. The skills, tool chains, and output shapes\nare identical; the packaging is Gemini-native.\n\n## Prerequisites\n\nThis extension depends on the **Valency Gemini connector extension**, which\nregisters the `valency` MCP server and handles OAuth authentication. Install\nand authenticate the connector first:\n\n```bash\ngemini extensions install https://github.com/valencyio/valency-gemini-extension\ngemini  # then inside the CLI:\n/mcp auth valency\n```\n\nWithout the connector, the skills have no MCP tools to call.\n\n## What's bundled\n\n- **Skills**: `profile`, `landscape`, `similar`, `trends`, `network`,\n  `reading-list`, `fresh-collaborators` — auto-discovered from `skills/` by\n  Gemini CLI. The model activates them on demand via `activate_skill`.\n- **Slash commands**: `/valency:profile`, `/valency:landscape`,\n  `/valency:similar`, `/valency:trends`, `/valency:network`,\n  `/valency:reading-list`, `/valency:fresh-collaborators` — thin wrappers in\n  `commands/valency/*.toml` that trigger the matching skill.\n- **Context file**: `GEMINI.md` — extension-level rules (no fabrication,\n  consistent markdown output, MCP-server expectations).\n\nThis extension does **not** register an MCP server. The connector does that.\n\n## Installation\n\n### From a local checkout\n\n```bash\ngemini extensions link /path/to/valency-gemini-skills\n```\n\n`link` symlinks the dev folder into Gemini CLI's extensions directory so edits\nare reflected immediately. Restart your Gemini CLI session to pick up new\nfiles.\n\nTo install a frozen copy:\n\n```bash\ngemini extensions install /path/to/valency-gemini-skills\n```\n\n### From a Git repo (once published)\n\n```bash\ngemini extensions install https://github.com/valency-oss/valency-gemini-skills\n```\n\n## Usage\n\n**TL;DR:** Gemini auto-activates the right skill from natural-language\nquestions. The slash commands are explicit triggers when you want a specific\nworkflow.\n\n### Profile — researcher overview\n\n```\n/valency:profile Yoshua Bengio\n```\n\nOr:\n\n```\nWho is Yoshua Bengio?\nWhat does Sara Walker work on?\nShow me Daphne Koller's publications\n```\n\n### Landscape — field overview\n\n```\n/valency:landscape cs.LG\n/valency:landscape protein folding\n```\n\n### Similar — find related papers\n\n```\n/valency:similar 1706.03762\n/valency:similar Attention Is All You Need\n```\n\n### Trends — topic evolution over time\n\n```\n/valency:trends cs.AI\n/valency:trends CRISPR\n/valency:trends cs.LG, cs.CL\n```\n\n### Network — collaboration mapping\n\n```\n/valency:network Yoshua Bengio\n```\n\nThe network skill includes a Divergence Analysis section showing how each top\ncollaborator's research focus has drifted from the focal author's — useful for\nseeing how a researcher's intellectual position has shifted relative to their\nclosest peers.\n\n### Reading list — curated bibliography for a researcher\n\n```\n/valency:reading-list David W. Hogg\n```\n\nTriangulates off the author's most-cited and most-recent papers to surface 5–8\nrecommendations per intellectual thread, with cross-thread papers (those that\nconnect multiple threads of the author's work) highlighted separately.\n\n### Fresh collaborators — expand a researcher's network\n\n```\n/valency:fresh-collaborators David W. Hogg\n```\n\nReturns researchers doing recent (last 12–18 months) thematically relevant\nwork who are **not** in the focal author's top-100 coauthor network. Each\ncandidate is tagged junior/senior and attributed to the theme(s) that surfaced\nthem.\n\n## Layout\n\n```\nvalency-gemini-skills/\n├── gemini-extension.json       # Manifest: name, version, contextFileName\n├── GEMINI.md                   # Extension-level context\n├── package.json                # npm-style metadata (homepage, keywords, etc.)\n├── LICENSE                     # MIT\n├── README.md\n├── commands/\n│   └── valency/\n│       ├── profile.toml\n│       ├── landscape.toml\n│       ├── similar.toml\n│       ├── trends.toml\n│       ├── network.toml\n│       ├── reading-list.toml\n│       └── fresh-collaborators.toml\n└── skills/\n    ├── profile/SKILL.md\n    ├── landscape/SKILL.md\n    ├── similar/SKILL.md\n    ├── trends/SKILL.md\n    ├── network/SKILL.md\n    ├── reading-list/SKILL.md\n    └── fresh-collaborators/SKILL.md\n```\n\n## License\n\nThis repo is MIT-licensed. See [LICENSE](./LICENSE).\n\nOrg-wide contribution, trademark, and security policies for the `valency-oss` organization are maintained at [valency-oss/.github](https://github.com/valency-oss/.github).\n",
  "bytes": 5005,
  "sha": "a3c91fcb3b8d615a37d83f6cbd3445b34ee8c9edd7a71055488ddcc43e5d3141",
  "repo_slug": "valency-oss/valency-gemini-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_valency_oss_valency_gemini_skills_b5492c8c/readme"
}