Skip to content
Back to search

vitaecontext

SkillGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/vitaecontext/vitaecontext with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/vitaecontext/vitaecontext'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vitaecontext--vitaecontext/badge.svg)](/listings/vitaecontext--vitaecontext)

HTML

<a href="/listings/vitaecontext--vitaecontext"><img src="/api/listings/vitaecontext--vitaecontext/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Set up with an agent

Copy this prompt into your agent. GitHub adds a copy control to the prompt block.

Set up VitaeContext for this agent environment.

- Read https://vitaecontext.github.io/docs/installation/ and https://vitaecontext.github.io/providers/ first. Identify the matching provider and its invocation format.
- Run `npx vitaecontext install --provider <matching-provider>`. Do not use `--force` or change install locations unless I approve it.
- Verify the installation with `npx vitaecontext doctor`, then tell me which skills are available and how to invoke them here.
- Ask me for a private file path, initialize it with `npx vitaecontext context init --output <private-path>`, and explain that validation will fail until its placeholders are replaced.
- Read https://vitaecontext.github.io/docs/usage/ and propose three practical next steps. Start with building the context from career material I choose to share, then suggest one focused skill for my immediate goal. Do not upload or share my files without asking.

Install the skills for an agent provider:

npx vitaecontext install --provider codex

Initialize a minimal Career Context file in a private location:

npx vitaecontext context init --output ~/.vitaecontext/name-surname-career-context.md

Ask an agent to build the context from trusted material:

Use vitaecontext-build to create my Career Context file.
I can provide my CV, LinkedIn sections, GitHub URL, portfolio URL, project notes,
screenshots, or other career material.

Keep the Career Context file private. A portable default location is:

~/.vitaecontext/<name-surname>-career-context.md

After filling it, validate the structure and create a bounded task packet:

npx vitaecontext context validate ~/.vitaecontext/name-surname-career-context.md
npx vitaecontext context summary ~/.vitaecontext/name-surname-career-context.md --for github --output /tmp/github-context.md

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 21 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  3. "name": "vitaecontext",
  4. "owner": {
  5. "name": "VitaeContext"
  6. },
  7. "plugins": [
  8. {
  9. "name": "vitaecontext",
  10. "source": "./",
  11. "description": "VitaeContext gives AI agents a private, reusable source of truth about a person's career, then provides focused skills for turning that context into grounded professional work.",
  12. "version": "2.4.0",
  13. "category": "productivity",
  14. "keywords": [
  15. "career",
  16. "vitaegraph"
  17. ],
  18. "license": "MIT"
  19. }
  20. ]
  21. }
README.md · README · 281 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src=".assets/image/banners/vitaecontext/vitaecontext-light.png" alt="VitaeContext — Keep your career context. Reuse it across AI." width="90%" />
  3. </p>
  4. <p align="center">
  5. <strong>Keep your career context. Reuse it across AI.</strong>
  6. </p>
  7. <p align="center">VitaeContext gives AI agents a private, reusable source of truth about a person's career, then provides focused skills and a Model Context Protocol (MCP) server for turning that context into grounded professional work.</p>
  8. <p align="center">
  9. <a href="https://www.npmjs.com/package/vitaecontext"><img src="https://img.shields.io/npm/v/vitaecontext?style=flat-square&logo=npm&color=CB3837" alt="npm version" /></a>
  10. <a href="#modules"><img src="https://img.shields.io/badge/agent_skills-3-2563EB?style=flat-square" alt="3 agent skills" /></a>
  11. <a href="#mcp-server"><img src="https://img.shields.io/badge/mcp_server-2024--11--05-0EA5E9?style=flat-square" alt="MCP Server" /></a>
  12. <a href="https://github.com/vitaecontext/vitaecontext/actions/workflows/validate.yml"><img src="https://img.shields.io/github/actions/workflow/status/vitaecontext/vitaecontext/validate.yml?branch=main&style=flat-square&logo=githubactions&logoColor=white&label=build" alt="build status" /></a>
  13. <a href="https://github.com/vitaecontext/vitaecontext/stargazers"><img src="https://img.shields.io/github/stars/vitaecontext/vitaecontext?style=flat-square&logo=github&label=stars" alt="GitHub stars" /></a>
  14. <a href="./LICENSE"><img src="https://img.shields.io/github/license/vitaecontext/vitaecontext?style=flat-square&label=license" alt="MIT license" /></a>
  15. <img src="https://img.shields.io/badge/formerly-AgentKit_SEO-1F684B?style=flat-square&labelColor=123C2D" alt="formerly AgentKit SEO" />
  16. </p>
  17. <p align="center">
  18. <a href="#why-vitaecontext">Why</a> •
  19. <a href="#how-it-works">How it works</a> •
  20. <a href="#quick-start">Quick start</a> •
  21. <a href="#mcp-server">MCP Server</a> •
  22. <a href="#vitaegraph">VitaeGraph</a> •
  23. <a href="#modules">Modules</a> •
  24. <a href="#install">Install</a> •
  25. <a href="#documentation">Documentation</a> •
  26. <a href="https://vitaecontext.github.io/">Website</a>
  27. </p>
  28. ---
  29. ## Why VitaeContext
  30. > Formerly AgentKit SEO. The project grew beyond profile SEO into reusable career context for grounded AI work. The deprecated `agentkit-seo` command remains available as a compatibility alias and forwards to the VitaeContext CLI.
  31. Every new AI chat starts with the same problem: the agent does not know which career facts are current, which claims have evidence, what role is being targeted, or how the output should change for each platform.
  32. The usual result is repeated explanation, inconsistent profiles, generic writing, and occasionally invented claims.
  33. VitaeContext applies the familiar `AGENTS.md` and `CLAUDE.md` pattern to professional identity. Its Context Builder skill turns a user's raw career material into a private Markdown source of truth called a **Career Context file**. A separate VitaeGraph skill keeps optional deeper career records, and a stateless MCP server makes both reusable across agents and downstream career tools.
  34. The goal is simple:
  35. - Explain professional context once instead of rebuilding it in every chat.
  36. - Keep facts, goals, constraints, proof links, and claims to avoid in one reusable file.
  37. - Reuse the same evidence in downstream tools without turning positioning into invention.
  38. - Reuse the workflow across supported AI coding agents via standard Agent Skills or a stateless MCP server.
  39. ### The context layer before career automation
  40. Many tools can draft a CV, tailor an application, write a message, or automate a career workflow. Those tools can only work from the career information they receive. When that input is scattered, stale, incomplete, or overstated, the same problems travel through the rest of the workflow.
  41. VitaeContext sits one logical layer before those systems. It helps create and maintain the private, evidence-bounded Career Context file that an agent, CV builder, application workflow, or other career tool can use as its starting point. VitaeContext is provider- and system-agnostic: it does not require a particular AI provider or downstream automation product. The file stays portable so it can be supplied wherever precise career context is needed.
  42. ## How it works
  43. <p align="center">
  44. <img src=".assets/image/public-visuals/vitaecontext/basic-workflow.png" alt="VitaeContext workflow: supplied career material becomes private Career Context, is reused through MCP or a bounded summary, and grounds downstream agents and tools" width="100%" />
  45. </p>
  46. 1. **Gather the raw material.** Start with CVs, profile sections, GitHub and portfolio links, exports, screenshots, and project notes.
  47. 2. **Create the Career Context file with VitaeContext.** Give the raw material to an AI agent and invoke `vitaecontext-build`. The skill interviews the user about direction, defining evidence, priorities, and unwanted claims, then organizes the material into a private Markdown file with a stable retrieval interface and personalized narrative hierarchy.
  48. 3. **Reuse it via MCP or a bounded summary.** Query the context through the MCP server, or pass a bounded summary packet to the agent or career tool doing the work.
  49. 4. **Produce grounded work.** Get an audit, rewrite, patch proposal, or action plan based on the supplied context.
  50. The Career Context file supplies facts and direction. Downstream skills and tools supply platform formatting and channel-specific constraints. They do not become a second source of truth.
  51. ---
  52. ## Quick start
  53. ### Set up with an agent
  54. Copy this prompt into your agent. GitHub adds a copy control to the prompt block.
  55. ```text
  56. Set up VitaeContext for this agent environment.
  57. - Read https://vitaecontext.github.io/docs/installation/ and https://vitaecontext.github.io/providers/ first. Identify the matching provider and its invocation format.
  58. - Run `npx vitaecontext install --provider <matching-provider>`. Do not use `--force` or change install locations unless I approve it.
  59. - Verify the installation with `npx vitaecontext doctor`, then tell me which skills are available and how to invoke them here.
  60. - Ask me for a private file path, initialize it with `npx vitaecontext context init --output <private-path>`, and explain that validation will fail until its placeholders are replaced.
  61. - Read https://vitaecontext.github.io/docs/usage/ and propose three practical next steps. Start with building the context from career material I choose to share, then suggest a context handoff for my immediate goal. Do not upload or share my files without asking.
  62. ```
  63. Install the skills for an agent provider:
  64. ```bash
  65. npx vitaecontext install --provider codex
  66. ```
  67. Initialize a minimal Career Context file in a private location:
  68. ```bash
  69. npx vitaecontext context init --output ~/.vitaecontext/name-surname-career-context.md
  70. ```
  71. Ask an agent to build the context from trusted material:
  72. ```text
  73. Use vitaecontext-build to create my Career Context file.
  74. I can provide my CV, LinkedIn sections, GitHub URL, portfolio URL, project notes,
  75. screenshots, or other career material.
  76. ```
  77. Keep the Career Context file private. A portable default location is:
  78. ```text
  79. ~/.vitaecontext/<name-surname>-career-context.md
  80. ```
  81. After filling it, validate the structure and create a bounded task packet:
  82. ```bash
  83. npx vitaecontext context validate ~/.vitaecontext/name-surname-career-context.md
  84. npx vitaecontext context summary ~/.vitaecontext/name-surname-career-context.md --for github --output /tmp/github-context.md
  85. ```
  86. ---
  87. ## MCP Server
  88. [VitaeContext MCP](./mcp/README.md) provides a stateless Model Context Protocol interface adhering to version `2024-11-05`.
  89. <p align="center">
  90. <img src=".assets/image/public-visuals/mcp/mcp-workflow.png" alt="VitaeContext MCP: Stateless Model Context Protocol bridge between coding workspaces and private career facts" width="100%" />
  91. </p>
  92. By registering the MCP server from the published `vitaecontext` package with your AI coding tool, agents across repositories can read your selected Career Context and VitaeGraph without copying career files into each codebase. For a task-specific read, use `list_career_context_sections` followed by `get_context_for_task`: it returns one selected heading under a strict size cap. Legacy broad context resources remain available, so this does not enforce access permissions.
  93. ```bash
  94. # Direct MCP stdio execution
  95. npx -y vitaecontext mcp
  96. ```
  97. ### Client configuration
  98. Add to your tool's MCP configuration (e.g. `claude_desktop_config.json`, Cursor Settings, or Windsurf config):
  99. ```json
  100. {
  101. "mcpServers": {
  102. "vitaecontext": {
  103. "command": "npx",
  104. "args": ["-y", "vitaecontext", "mcp"]
  105. }
  106. }
  107. }
  108. ```
  109. See [mcp/README.md](./mcp/README.md) and [mcp/config-examples/](./mcp/config-examples/) for complete setup instructions across Claude Desktop, Claude Code, Cursor, Windsurf, Roo Code, Antigravity, IBM Bob, and Grok.
  110. ---
  111. ## VitaeGraph
  112. [VitaeGraph](./vitaegraph/README.md) is VitaeContext's deeper structured-memory layer, not a separate product. Use the Career Context file for compact, repeated facts and quick grounded drafts. Use VitaeGraph when an agent needs detailed records for projects, roles, degrees, courses, thesis work, certifications, awards, publications, and the relationships between them.
  113. <p align="center">
  114. <img src=".assets/image/public-visuals/vitaegraph/vitaegraph-diff.png" alt="Comparison between the compact Career Context file for fast facts and VitaeGraph for deep hierarchical records" width="100%" />
  115. </p>
  116. Its root directory is an independently readable product entrypoint containing the format specification, schema, graph model, and canonical templates. Markdown remains canonical; generated JSON files are rebuildable local indexes.
  117. ```text
  118. ~/.vitaecontext/
  119. ├── <name-surname>-career-context.md
  120. └── vitaegraph/
  121. ```
  122. Create and check the default private graph:
  123. ```bash
  124. npx vitaecontext graph init
  125. npx vitaecontext graph validate
  126. npx vitaecontext graph index
  127. ```
  128. ---
  129. ## Modules
  130. VitaeContext ships one compact-context module and VitaeGraph, coordinated by the root routing skill.
  131. | Goal | Module | Public playbook |
  132. | --- | --- | --- |
  133. | Build the reusable Career Context layer | [`vitaecontext-build`](./hub/context-builder/README.md) | [Context Builder](https://vitaecontext.github.io/playbooks/context-builder/) |
  134. | Build a detailed local career knowledge graph | [`vitaecontext-vitaegraph`](./skills/vitaecontext-vitaegraph/SKILL.md) | [VitaeGraph specification and templates](./vitaegraph/README.md) |
  135. ---
  136. ## Install
  137. Install one provider at a time:
  138. ```bash
  139. npx vitaecontext install --provider codex
  140. ```
  141. Supported providers:
  142. | Provider | Default destination | Activation model |
  143. | --- | --- | --- |
  144. | `shared` | Portable `SKILL.md` folders | Manual reuse or packaging |
  145. | `claude-code` | `~/.claude/skills/` | Ask for the installed skill by name |
  146. | `codex` | `~/.agents/skills/` plus `CODEX_HOME/skills` or `~/.codex/skills/` | Use installed skills by name when available |
  147. | `gemini-cli` | `~/.gemini/extensions/vitaecontext/` | Namespaced commands such as `/vitaecontext:context` |
  148. | `antigravity` | `~/.gemini/antigravity-cli/plugins/vitaecontext/` | Gemini-compatible plugin layout |
  149. | `opencode` | `~/.config/opencode/skills/` plus command wrappers | Native skill loading and flat command wrappers |
  150. | `cursor` | `.cursor/skills/` | Native Cursor Agent Skills |
  151. | `windsurf` | `.windsurf/skills/` | Native Windsurf Cascade Skills |
  152. | `roo-code` | `.roo/skills/` | Native Roo Code / Cline Skills |
  153. | `ibm-bob` | `.ibm/skills/` | IBM Bob / watsonx Code Assistant Skills |
  154. | `grok` | `.grok/skills/` | xAI Grok Agent Skills |
  155. For Claude Code, the skills are also available through the plugin marketplace:
  156. ```text
  157. /plugin marketplace add vitaecontext/vitaecontext
  158. /plugin install vitaecontext@vitaecontext
  159. ```
  160. Useful package commands:
  161. ```bash
  162. npx vitaecontext version
  163. npx vitaecontext mcp
  164. npx vitaecontext update
  165. npx vitaecontext doctor
  166. npx vitaecontext list providers
  167. npx vitaecontext list skills
  168. npx vitaecontext context init
  169. npx vitaecontext context validate ~/.vitaecontext/career-context.md
  170. npx vitaecontext context summary ~/.vitaecontext/career-context.md --for cv
  171. npx vitaecontext graph init
  172. npx vitaecontext graph validate
  173. npx vitaecontext graph index
  174. ```
  175. ---
  176. ## What is inside
  177. This repository keeps human guidance, runtime skills, provider adapters, MCP, and packaging separate:
  178. - [`hub/`](./hub/) contains public playbooks, templates, examples, and source notes.
  179. - [`vitaegraph/`](./vitaegraph/) contains the public VitaeGraph specification, schemas, and canonical artifact templates.
  180. - [`skills/`](./skills/) contains the canonical portable standard Agent Skills.
  181. - [`src/`](./src/) and [`bin/`](./bin/) contain the core engine, CLI, and stateless MCP server.
  182. - [`providers/`](./providers/) contains thin provider-specific adapters.
  183. - [`mcp/`](./mcp/) contains Model Context Protocol documentation, client configs, and protocol contracts.
  184. - [`llms.txt`](./llms.txt) and [`llms-full.txt`](./llms-full.txt) expose the project map and wiki bundle to LLM tools.
  185. Read [DESIGN.md](./DESIGN.md) for the system design and [the architecture map](./.assets/docs/architecture-map.md) for repository ownership and edit boundaries.
  186. ## Documentation
  187. - [Getting started](./.assets/docs/getting-started.md) explains installation, first use, and graph navigation.
  188. - [Fictional five-minute demo](./.assets/docs/fictional-end-to-end-demo.md) shows raw material, validated context, a bounded packet, and a grounded task brief without publishing real career data.
  189. - [End-to-end demos](./.assets/docs/end-to-end-workflows.md) provides sample inputs, prompts, and expected deliverables.
  190. - [Public playbooks](./hub/) document the human-readable methodology for each module.
  191. - [Model Context Protocol](./mcp/README.md) details cross-project MCP integration.
  192. - [Maintaining](./MAINTAINING.md) covers source refresh, wiki maintenance, validation, and releases.
  193. - [Contributing](./CONTRIBUTING.md) explains how to propose ideas, report issues, and open pull requests.
  194. - [Contributing instructions](./AGENTS.md) define repository rules for coding agents.
  195. - [Changelog](./CHANGELOG.md) records public release history.
  196. - [Privacy](./PRIVACY.md) and [security](./SECURITY.md) describe project policies.
  197. ## Authors
  198. Maintained by **Renato Mignone** and **Elia Innocenti**.
  199. | Author | GitHub | LinkedIn | Portfolio |
  200. | --- | --- | --- | --- |
  201. | **Renato Mignone** | [GitHub](https://github.com/RenatoMignone) | [LinkedIn](https://www.linkedin.com/in/renato-mignone/) | [Portfolio](https://renatomignone.github.io/) |
  202. | **Elia Innocenti** | [GitHub](https://github.com/eliainnocenti) | [LinkedIn](https://www.linkedin.com/in/eliainnocenti/) | [Portfolio](https://eliainnocenti.github.io/) |
  203. If VitaeContext is useful, [star the repository](https://github.com/vitaecontext/vitaecontext) to help more people find it.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.