project-import

Create a Speck project structure with a skeleton project.md file.

2|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/telum-ai/speck --skill project-import
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-import
Source: https://github.com/telum-ai/speck/tree/main/.cursor/skills/project-import
Command: npx skills add https://github.com/telum-ai/speck --skill project-import

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the initial setup of Speck's project structure for existing codebases, streamlining the onboarding process for brownfield projects.

Core Features & Use Cases

  • Lightweight Project Setup: Quickly creates the necessary directories and a skeleton project.md file.
  • Handles Various Scenarios: Supports code-only, docs-only, or combined existing projects.
  • Use Case: You have a legacy application and want to start managing it with Speck. Running this Skill will set up the foundational files, allowing you to then run /project-scan to begin analysis.

Quick Start

Use the project-import skill to set up Speck for my existing project located at /path/to/my/code.

Frequently Asked Questions about project-import

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I import an existing codebase into Speck structure?

You can import an existing codebase into Speck structure by running this skill, which identifies your project type, primary language, and documentation locations to generate a skeleton project.md file and foundational directories.

What is the best way to set up project initialization for brownfield development?

For brownfield development project initialization, this skill automates setting up the Speck structure for existing code, handling code-only, docs-only, or combined projects to streamline the onboarding process.

Can I use Speck for a legacy application that only has existing documentation?

Yes, you can use Speck for a legacy application with existing documentation. The project-import skill handles docs-only projects by generating the foundational structure needed to begin analysis.

What steps should I take after generating the project.md file?

After generating the project.md file, you should run subsequent analysis commands like /project-scan, /project-context, and /project-architecture to perform detailed analysis on your imported codebase.

Does project setup with Speck require identifying the primary language?

Project setup with Speck identifies the primary language of your existing codebase automatically. It uses this information along with project type and existing documentation locations to establish the foundational structure.