Automated file templates


VimTricks reader Kyle recently wrote in to ask about file templates. There are plenty of snippet and templating plugins out there. But did you know Vim has a built-in concept called skeleton files which allow you to automatically populate a new file with a given template? Learn about it with :help skeleton but let’s dive into it.

The general idea of skeleton files is that you configure your Vim to read a template from disk every time you open a new, empty buffer with a filename that matches a given pattern. One example might be when writing shell scripts. You can create a skeleton file that contains the Bash shebang line like so:

#!/usr/bin/env bash

Then configure your Vim to populate any new and empty buffer that ends in .sh with this file contents. If you’re working in a language that requires a lot of boilerplate in every file, this can be an enormous time saver.

Another example use case is a README file. You could create a template Markdown file that includes all the headings and basic bullet points that every good README should have. Then whenever you open a new file called in Vim, the buffer will automatically pre-populate with the skeleton template file.

Configuring these templates in your .vimrc is simple:

autocmd BufNewFile 0r ~/skeletons/
autocmd BufNewFile *.sh 0r ~/skeletons/

In this case, I’ve created a new directory inside my home directory called skeletons but you could put these anywhere. Here’s how this works:

  • autocmd – run this automatically on some event
  • BufNewFile – this is Vim’s new file event
  • – this is the pattern you want the new file to match
  • 0r – read into the buffer starting at line 0, the first line
  • ~/skeletons/ – the file to read in

There’s a quick demo of this in action below. Let us know what you think in the comments. Do you have any use cases where this is handy? And please reach out with other content you’d like to see covered in future issues of VimTricks.

How useful was this tip?

Average rating 4.8 / 5. Vote count: 100

No votes so far! Be the first to rate this tip.

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?

Written by

Colin Bartlett

102 Posts

Vim enthusiast and software developer for more than 20 years.
View all posts